Making API requests on behalf of end users (Zendesk Support)

In Zendesk Support, an authenticated admin can make API requests on behalf of any end user. The end user's email doesn't need to be verified. If a record is created, updated, or deleted, the change is associated with the end user, not the admin.

Making requests on behalf of end users consists of the following steps:

1. Obtaining an OAuth access token with an impersonate scope
2. Making the request

Related articles

• Getting an OAuth access token for testing purposes
• Using OAuth authentication with your application

Obtaining an OAuth access token with an impersonate scope

1. If not already done, create an OAuth client in Zendesk Support (Admin > API > OAuth Clients).

2. When requesting or creating the OAuth access token, specify an "impersonate" scope.

   Example when creating the access token with the API:

   curl https://{subdomain}.zendesk.com/api/v2/oauth/tokens.json \
   -H "Content-Type: application/json" \
   -d '{"token": {"client_id": "your_client_id", "scopes": ["impersonate", "write"]}}' \
   -X POST -v -u {email_address}:{password}
   

   Only admins can use the API to create OAuth access tokens.

   Example when sending a user to the authorization page in an authorization flow:

   https://z3napi.zendesk.com/oauth/authorizations/new?client_id=my_test_client&scope=impersonate+write&response_type=code
   

Making the request

Only Zendesk Support admins can make requests on behalf of end users.

1. In your request, use the access token to set an "Authorization" header. cURL example:

   -H "Authorization: Bearer 8b56769914d4c38617a389cab95124042c3c3eadf3f66d5dc9d7df2a7bca21e2"

2. Set a "X-On-Behalf-Of" header that specifies either the user's username (the user's email address), or user ID. Examples:

   -H "X-On-Behalf-Of: [e-mail]"

   or

   -H "X-On-Behalf-Of: 203427634"

Example request

curl https://z3napi.zendesk.com/api/v2/tickets/1/satisfaction_rating \
  -H "Authorization: Bearer 8d56769914d4a38617a389cab90524042c3c3ebdf3f66d5dc9d7df2a7bca21e2" \
  -H "X-On-Behalf-Of: [e-mail]" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"satisfaction_rating": {"score": "good", "comment": "Awesome support."}}'

The example adds a satisfaction rating to the ticket.

Note: The Create Satisfaction Rating endpoint only works on tickets with a status of Solved, or on tickets that were reopened after being solved. The endpoint doesn't work on tickets with a status of Closed or on archived tickets. For more information, see What's the difference between a solved ticket and a closed ticket.