POST /api/v2/users/create_or_update

Creates a user if the user does not already exist, or updates an existing user identified by e-mail address or external ID.

If you don't specify a role parameter, the new user is assigned the role of end user.

If you need to create users without sending out a verification email, include a "skip_verify_email": true property in the body.

External ID Case Sensitivity

When providing an external id to identify an existing user to update, the search for the user record is not case sensitive.

However, if an existing user is found, the system will update the user's external id to match the case of the external id used to find the user.

Response Status Code

• If the user already exists in Zendesk, a successful request returns a 200 OK status code.
• If the user does not exist in Zendesk and is created, the request returns a 201 Created status code.
• In both cases, the API responds with a JSON body containing the full user object, which includes the user's id and the fully-resolved URL to the user resource.

Example response:

{
  "user": {
    "id": 8929981612030,
    "url": "https://{subdomain}.zendesk.com/api/v2/users/8929981612030.json",
  ...
  }
}

Allowed For

• Admins and agents in custom roles with permission to manage end users or team members

Servers

• https://{subdomain}.{domain}.com

Request headers

Request body fields

How to start integrating

1. Add HTTP Task to your workflow definition.
2. Search for the API you want to integrate with and click on the name.
   • This loads the API reference documentation and prepares the Http request settings.
3. Click Test request to test run your request to the API and see the API's response.