# Create a role assignment

**POST /Organizations/{OrganizationSid}/RoleAssignments**

Create a role assignment for the given organization


## Servers
- https://preview-iam.twilio.com: https://preview-iam.twilio.com ()


## Authentication methods
- O auth2 client credentials


## Parameters

### Path parameters
- **OrganizationSid** (string(OrganizationSid))



### Body: application/json (object)

- **role_sid** (string(IamRoleSid))
  Twilio Role Sid representing assigned role
- **scope** (string(Sid))
  Twilio Sid representing scope of this assignment
- **identity** (string(Sid))
  Twilio Sid representing identity of this assignment


## 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(IamRoleAssignmentSid))
  Twilio Role Assignment Sid representing this role assignment
- **role_sid** (string(IamRoleSid))
  Twilio Role Sid representing assigned role
- **scope** (string(Sid))
  Twilio Sid representing identity of this assignment
- **identity** (string(Sid))
  Twilio Sid representing scope of this assignment

### 400
Bad request or business rules violation
#### 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/scim+json (object)
- **code** (integer(int32))
  Twilio-specific error code
- **message** (string)
  Error message
- **moreInfo** (string)
  Link to Error Code References
- **status** (integer(int32))
  HTTP response status code

### 403
Unauthorized
#### 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/scim+json (object)
- **code** (integer(int32))
  Twilio-specific error code
- **message** (string)
  Error message
- **moreInfo** (string)
  Link to Error Code References
- **status** (integer(int32))
  HTTP response status code


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