Sign in
User Identities

Create Identity

Adds an identity to a user's profile. An agent can add an identity to any user profile.

Supported identity types:

TypeExample
email{ "type" : "email", "value" : "someone@example.com" }
twitter{ "type" : "twitter", "value" : "screen_name" }
facebook{ "type" : "facebook", "value" : "855769377321" }
google{ "type" : "google", "value" : "example@gmail.com" }
agent_forwarding{ "type" : "agent_forwarding", "value" : "+1 555-123-4567" }
phone_number{ "type" : "phone_number", "value" : "+1 555-123-4567" }

To create an identity without sending out a verification email, include a "skip_verify_email": true property. The "skip_verify_email": true property does not apply when updating your own agent profile. A welcome or verification email will be sent regardless of this setting.

Allowed For

  • Agents
post/api/v2/users/{user_id}/identities

Response

Created response

Example response

{
  "identity": {
    "created_at": "2011-07-20T22:55:29Z",
    "deliverable_state": "deliverable",
    "id": 35436,
    "primary": true,
    "type": "email",
    "updated_at": "2011-07-20T22:55:29Z",
    "url": "https://company.zendesk.com/api/v2/users/135/identities/35436.json",
    "user_id": 135,
    "value": "someone@example.com",
    "verification_method": "full",
    "verified": true,
    "verified_at": "2011-07-20T22:55:29Z"
  }
}

Changes