Zendesk

Zendesk User Identities API

The User Identities API from Zendesk — 5 operation(s) for user identities.

Documentation GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/users/{user_id}/identities List a user's identities · Zendesk Get Api V2 Users User_id Identities #

Ask an LLM

“Which emails, phone numbers and social accounts are attached to a user?”

“Can I list only the email identities of a user?”

Tell an agent

List all identities on the user's profile.

Show the user's identities of type {type}.

POST /api/v2/users/{user_id}/identities Add an identity to a user · Zendesk Post Api V2 Users User_id Identities #

Ask an LLM

“How do I add a second email address or phone number to a user's profile?”

“Which identity types can be added, such as google or agent_forwarding?”

Tell an agent

Add a new email identity to the user's profile.

Attach phone number identity {type} to this user.

GET /api/v2/users/{user_id}/identities/{user_identity_id} Show a user identity · Zendesk Get Api V2 Users User_id Identities User_identity_id #

Ask an LLM

“Can I view one specific identity on a user's profile?”

“What can an end user see when viewing one of their own identities?”

Tell an agent

Show one identity from the user's profile by identity ID.

Fetch the details of a single user identity.

PUT /api/v2/users/{user_id}/identities/{user_identity_id} Update or unverify a user identity · Zendesk Put Api V2 Users User_id Identities User_identity_id #

Ask an LLM

“Can I change the value of an existing email identity?”

“Is there a way to mark a verified identity as unverified again?”

Tell an agent

Change the value of the user's identity to the new address.

Unverify that user identity by setting verified to false.

DELETE /api/v2/users/{user_id}/identities/{user_identity_id} Delete a user identity · Zendesk Delete Api V2 Users User_id Identities User_identity_id #

Ask an LLM

“Can I remove an old email or phone identity from a user?”

“Why is a phone number still visible on the profile after deleting its identity?”

Tell an agent destructive · confirm first

Delete that identity from the user's profile.

Remove the outdated phone identity from this user.

PUT /api/v2/users/{user_id}/identities/{user_identity_id}/make_primary Make an identity primary · Zendesk Put Api V2 Users User_id Identities User_identity_id Make_primary #

Ask an LLM

“How do I change which email is a user's primary identity?”

“Can the primary flag be changed through the regular identity update?”

Tell an agent

Make that identity the user's primary one.

Set this email identity as primary for the user.

PUT /api/v2/users/{user_id}/identities/{user_identity_id}/request_verification Send a verification email for an identity · Zendesk Put Api V2 Users User_id Identities User_identity_id… #

Ask an LLM

“Can I send a user an email asking them to confirm they own an address?”

“What does the user receive when verification is requested?”

Tell an agent

Send the user a verification email for that email identity.

Ask the customer to verify ownership of their email address.

PUT /api/v2/users/{user_id}/identities/{user_identity_id}/verify Mark an identity as verified · Zendesk Put Api V2 Users User_id Identities User_identity_id Verify #

Ask an LLM

“Can an agent mark a user's identity verified without sending an email?”

“Why can't I verify the account owner's email identity this way?”

Tell an agent

Mark that user identity as verified directly.

Set the customer's identity to verified on their behalf.

Zendesk User Identities API

Operations 8

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification