---
title: "Create a role assignment"
method: POST
path: "/Organizations/{OrganizationSid}/RoleAssignments"
tags: ["RoleAssignments"]
---

# Create a role assignment

`POST /Organizations/{OrganizationSid}/RoleAssignments`

Create a role assignment for the given organization

## Path parameters

- `OrganizationSid` string, OrganizationSid, required

## Request body

- PublicApiCreateRoleAssignmentRequest
  - `role_sid` string, IamRoleSid, required — Twilio Role Sid representing assigned role
  - `scope` string, Sid, required — Twilio Sid representing scope of this assignment
  - `identity` string, Sid, required — Twilio Sid representing identity of this assignment
  - `resource_type` string, nullable — The resource type for resource-level role assignments
  - `resource_id` string, nullable — The resource id for resource-level role assignments

## Response `201`

Created

- PublicApiRoleAssignmentResponse
  - `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
  - `resource_type` string, nullable — The resource type for resource-level role assignments
  - `resource_id` string, nullable — The resource id for resource-level role assignments

## Other responses

- `400` — Bad request or business rules violation
- `403` — Unauthorized

## Changes

- **2026-05-06** `36dcc2ee4b55` — 4 info
  - added the new optional request property `resource_id`
  - added the new optional request property `resource_type`
  - added the optional property `resource_id` to the response with the `201` status
  - added the optional property `resource_type` to the response with the `201` status

[Change history](https://skmtc.dev/twilio/apis/iam-organizations/changes/Organizations/:OrganizationSid/RoleAssignments/post.md)

---

[API](https://skmtc.dev/twilio/apis/iam-organizations.md) · [All operations](https://skmtc.dev/twilio/apis/iam-organizations/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/iam-organizations/revisions/fff41bbd8220?raw)