# Create user

**POST /v1/Services/{ServiceSid}/Users**


Unique chat users within a chat service

## Servers
- https://chat.twilio.com: https://chat.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) to create the resource under.


### Body: application/x-www-form-urlencoded (object)

- **Identity** (string)
  The `identity` value that uniquely identifies the new resource's [User](https://www.twilio.com/docs/api/chat/rest/v1/user) within the [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). This value is often a username or email address. See the Identity documentation for more details.
- **RoleSid** (string)
  The SID of the [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the new User.
- **Attributes** (string)
  A valid JSON string that contains application-specific data.
- **FriendlyName** (string)
  A descriptive string that you create to describe the new resource. This value is often used for display purposes.


## Responses
### 201
Created
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the User resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the User resource.
- **service_sid** (string | null)
  The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with.
- **attributes** (string | null)
  The JSON string that stores application-specific data. **Note** If this property has been assigned a value, it's only  displayed in a FETCH action that returns a single resource; otherwise, it's null. If the attributes have not been set, `{}` is returned.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **role_sid** (string | null)
  The SID of the [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the user.
- **identity** (string | null)
  The application-defined string that uniquely identifies the resource's User within the [Service](https://www.twilio.com/docs/api/chat/rest/services). This value is often a username or an email address. See [access tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more info.
- **is_online** (boolean | null)
  Whether the User is actively connected to the Service instance and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service's `reachability_enabled` is `false`, if the User has never been online for the Service instance, even if the Service's `reachability_enabled` is `true`.
- **is_notifiable** (boolean | null)
  Whether the User has a potentially valid Push Notification registration (APN or GCM) for the Service instance. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service's `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service's `reachability_enabled` is `true`.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
- **joined_channels_count** (integer)
  The number of Channels this User is a Member of.
- **links** (object(uri-map) | null)
  The absolute URLs of the [Channel](https://www.twilio.com/docs/chat/api/channels) and [Binding](https://www.twilio.com/docs/chat/rest/bindings-resource) resources related to the user.
- **url** (string(uri) | null)
  The absolute URL of the User resource.


[Powered by Bump.sh](https://bump.sh)