Allowed Scopes: experimental:user:manage
Create users in the company the token resolves to, and send each of them an invitation. Only active admins and account owners can perform this operation, and users can only be created with the requester or controller role.
Send an array of 1 to 50 users; a single object outside an array is rejected with a 400. Users are created one after the other, and a user that fails does not prevent the others from being created: each one gets its own outcome in items, in request order, also when the array has a single user.
Creating never updates an existing user. Retrying a request is safe: users created by an earlier attempt come back as emailUnavailable, without their id, so read them back with the list of users.
The whole request is refused, and nobody is created, when the company has no seat left for the users to create (409), or when it is churned or managed by an HRIS integration (403).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||