---
title: "Invite a new or existing user to account"
method: POST
path: "/account/users/invite"
tags: ["account users"]
---

# Invite a new or existing user to account

`POST /account/users/invite`

## Request body

- AccountUserInviteInput — Input for inviting a user to an account
  - `account_role` 'account_member' | 'account_admin', required — The role in the account to assign to the user
  - `email` string, required — Email of this user
  - `user_attrs` object — Properties to set for a new user
    - `company` string, nullable — Name of the company this user belongs to
    - `first_name` string — First name of this user
    - `job_title` string, nullable — Title this user holds at their job
    - `last_name` string — Last name of this user
    - `phone_number` string, nullable — Phone number of this user

## Response `200`

Successful response

- AccountUser — General info for user in an account with count of account projects involved in
  - `user` User, required — General information of a user
    - `id` integer, required — ID of user
    - `account_id` integer, nullable — ID of the account this user belongs to
    - `invited_by_id` integer, nullable — ID of the user who invited this user to the platform
    - `is_email_deliverable` boolean, required — If email can be delivered to this user
    - `company` string, nullable — Name of the company this user belongs to
    - `company_type` 'ARCHITECT_SLASH_DESIGNER' | 'GENERAL_CONTRACTOR' | 'OWNER' | 'SPECIALTY_CONTRACTOR' | 'OTHER' | 'null', nullable — Type of the company this user belongs to
    - `email` string, required — Email of this user
    - `first_name` string, required — First name of this user
    - `job_title` string, nullable — Title this user holds at their job
    - `language` string, required — Preferred language of this user
    - `last_name` string, required — Last name of this user
    - `phone_number` string, nullable — Phone number of this user
    - `photo_url` string, nullable — URL where the profile picture of this user lives
    - `email_notifications` 'never' | 'daily' | 'instantly' | 'null', nullable — Email notification preference of this user for delivering task updates
    - `sync_scheme` 'smart_cellular' | 'full_cellular', required — Synchronization scheme of this user used by the mobile apps
    - `account_role` 'account_member' | 'account_admin' — The role of the user in the account they belong to
    - `email_addresses` object[] — Deprecated. Use the "email" property instead
    - `is_confirmed` boolean — Whether the user has accepted the invitation if there was one
    - `created_at` string, date-time, required — Time when the server created this user
    - `current_sign_in_at` string, date-time, nullable — Last time the user was seen online
    - `in_app_purchase_end_at` string, date-time, nullable — When the in app purchase this user made ends
    - `updated_at` string, date-time, required — Time when the server last updated this user
    - `trade_type` 'CONCRETE' | 'EARTHWORK' | 'ELECTRICAL' | 'FIRE_SUPPRESSION' | 'FRAMING_AND_OR_DRYWALL' | 'HVAC' | 'LOW_VOLTAGE' | 'MECHANICAL' | 'PLUMBING' | 'UTILITIES' | 'OTHER' | 'null', nullable — Type of the trade this user's company belongs to
  - `projects` integer, required — Number of projects in this account this user is a part of

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-super-api.md) · [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-super-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fieldwire/fieldwire-super-api/revisions/66ee1c20b92d/schema)