---
title: "Create Identity"
method: POST
path: "/api/v2/users/{user_id}/identities"
tags: ["User Identities"]
---

# Create Identity

`POST /api/v2/users/{user_id}/identities`

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

Supported identity types:

| Type             | Example |
| ---------------- | ------- |
| 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

## Response `201`

Created response

- UserIdentityResponse
  - `identity` UserIdentityObject
    - `created_at` string, date-time — The time the identity was created
    - `deliverable_state` string — Email identity type only. Indicates if Zendesk sends notifications to the email address. See [Deliverable state](#deliverable-state)
    - `id` integer — Automatically assigned on creation
    - `primary` boolean — If the identity is the primary identity. *Writable only when creating, not when updating. Use the [Make Identity Primary](#make-identity-primary) endpoint instead
    - `type` 'email' | 'twitter' | 'facebook' | 'google' | 'phone_number' | 'agent_forwarding' | 'any_channel' | 'foreign' | 'sdk', required — The type of this identity
    - `undeliverable_count` integer — The number of times a soft-bounce response was received at that address
    - `updated_at` string, date-time — The time the identity was updated
    - `url` string — The API url of this identity
    - `user_id` integer, required — The id of the user
    - `value` string, required — The identifier for this identity, such as an email address
    - `verification_method` 'none' | 'low' | 'sso' | 'embed' | 'full' — Indicates the state of user identity verification. See [Verification method](#verification-method).
    - `verified` boolean — If the identity has been verified. Deprecated. Use `verification_method` as a more accurate representation of a user's state of verification.
    - `verified_at` string, date-time, nullable — The last time a full verification flow was completed for the identity

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)