ConversationsUser

Create User

POST
/v1/Users

Add a new conversation user to your account's default service

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Header Parameters

X-Twilio-Webhook-Enabled?UserHookEnabledType

The X-Twilio-Webhook-Enabled HTTP request header

Value in

  • "true"
  • "false"

Request Body

application/x-www-form-urlencoded

Identity*string

The application-defined string that uniquely identifies the resource's User within the Conversation Service. This value is often a username or an email address, and is case-sensitive.

FriendlyName?string

The string that you assigned to describe the resource.

Attributes?string

The JSON Object string that stores application-specific data. If attributes have not been set, {} is returned.

RoleSid?string

The SID of a service-level Role to assign to the user.

Match^RL[0-9a-fA-F]{32}$
Length34 <= length <= 34

Response Body

application/json

curl -X POST "https://example.com/v1/Users" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'Identity=admin&FriendlyName=name&Attributes=%7B+%22duty%22%3A+%22tech%22+%7D&RoleSid=RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
{  "sid": "USaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "identity": "admin",  "friendly_name": "name",  "attributes": "{ \"duty\": \"tech\" }",  "is_online": true,  "is_notifiable": null,  "date_created": "2019-12-16T22:18:37Z",  "date_updated": "2019-12-16T22:18:38Z",  "url": "https://conversations.twilio.com/v1/Users/USaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "links": {    "user_conversations": "https://conversations.twilio.com/v1/Users/USaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations"  }}