Create a user

Create a new user. The currently signed-in user must have the ADMINISTRATOR user role in the BILL organization to perform this operation.

When you create a user, BILL sends an email to the user for them to complete their sign-up. After user sign-up is complete, the user can access features in your BILL organization depending on the user role.

See Organizations and Users in the Guides section for more information, sample requests, and responses.

Body Params
string
required
length between 1 and 100

User first name

string
required
length between 1 and 100

User last name

string
required
length ≥ 1

User email address

string
required
length ≥ 1

BILL-generated ID of the user role. The value begins with 0po.

If you do not set roleId, the default ADMINISTRATOR user role is assigned to the created user. You can get the list of available user roles with GET /v3/roles.

boolean
required

Set as true if the user accepts the BILL terms of service

Headers
string | null

API session ID generated with /v3/login

string | null

Developer key generated with your BILL developer account

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json