Create or Invite a user

Creates a new user or invites an existing email into this customer. Requires user:write or usermanagement.write. Empty role lists on an instance receive the configured minimum role.

Request

POST /user

Headers

Header	Value
`Authorization`	`Bearer <token>` (or HMAC headers, see Authentication)
`Content-Type`	`application/json`

Request Body

Field	Type	Required	Description
`email`	string	Yes	Email address (stored lowercased).
`instances`	object	Yes	Map of instance identifiers to arrays of Auth0 role IDs. Use `"*"` for all instances.
`create_storefront`	boolean	No	When `true`, storefront credentials are included in the invite email.

Example Request

{
  "email": "[email protected]",
  "instances": {
    "live": ["rol_abc"]
  },
  "create_storefront": false
}

Response

{
  "users": [
    {
      "user_id": "auth0|def456",
      "email": "[email protected]",
      "instances": {
        "live": ["rol_abc"]
      }
    }
  ],
  "created": true
}

created is true for a new identity, false when an existing user was granted access to this customer.