Create Identity

POST {{baseUrl}}/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:

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 "verified": true property.

Allowed For

  • Agents

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: Created

{"identity":{"created_at":"2012-02-12T14:25:21Z","id":77938,"primary":false,"type":"twitter","updated_at":"2012-02-12T14:25:21Z","user_id":13531,"value":"cabanaboy","verified":false}}