Method: users.insert

Creates a user.

Mutate calls immediately following user creation might sometimes fail as the user isn't fully created due to propagation delay in our backends. Check the error details for the "User creation is not complete" message to see if this is the case. Retrying the calls after some time can help in this case.

If resolveConflictAccount is set to true, a 202 response code means that a conflicting unmanaged account exists and was invited to join the organization. A 409 response code means that a conflicting account exists so the user wasn't created based on the handling unmanaged user accounts option selected.

HTTP request

POST https://admin.googleapis.com/admin/directory/v1/users

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
resolveConflictAccount

boolean

Optional. If set to true, the option selected for handling unmanaged user accounts will apply. Default: false

Request body

The request body contains an instance of User.

Response body

If successful, the response body contains a newly created instance of User.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/admin.directory.user

For more information, see the Authorization guide.