Users

Create a user

Create a new user in the authenticated entity. Only administrators can create users. A successful request returns the same fields as Get a user, without access.

post/v1/users

Request

  • Base URL: https://api.getaccept.com
  • URL: https://api.getaccept.com/v1/users
  • Auth: HTTP bearer

Request body

emailstring required

Email of the user.

first_namestring

First name of the user. Ignored when an account with this email already exists.

last_namestring

Last name of the user. Ignored when an account with this email already exists.

titlestring

Title of the user, for example CEO or Sales manager. Ignored when an account with this email already exists.

phonestring

Phone number of the user in international format. Ignored when an account with this email already exists.

mobilestring

Mobile number of the user in international format. Ignored when an account with this email already exists.

notestring

Internal note about the user. Ignored when an account with this email already exists.

role'admin' | 'user' | 'manager'

Role the user has in this entity.

languagestring

Language of the new user as an ISO 639 code, for example en or sv. Defaults to the entity language. Ignored when an account with this email already exists.

team_idstring

Id of a team to add the user to.

team_idsstring[]

Ids of the teams to add the user to. Combined with team_id when both are given.

skip_invitationboolean

Set to true to add a new account as active without sending an invitation email. Defaults to false, which adds the user as pending and sends an invitation. When an account with this email already exists, it is ignored: the user is added as pending and invited, unless they already have an active profile in the same organization, in which case they are added as active without an invitation.

Response

The request succeeded.

Changes

No recorded changes to this operation across all 1 revision of this API.