---
title: "POST /v2/Services/{ServiceSid}/Roles"
method: POST
path: "/v2/Services/{ServiceSid}/Roles"
tags: ["IpMessagingV2Role"]
---

# POST /v2/Services/{ServiceSid}/Roles

`POST /v2/Services/{ServiceSid}/Roles`

## Request

- Base URL: `https://ip-messaging.twilio.com`
- URL: `https://ip-messaging.twilio.com/v2/Services/{ServiceSid}/Roles`
- Auth: HTTP basic

## Path parameters

- `ServiceSid` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `FriendlyName` string, required
  - `Type` 'channel' | 'deployment', required
  - `Permission` string[], required

## Response `201`

Created

- IpMessagingV2ServiceRole
  - `sid` string, nullable
  - `account_sid` string, nullable
  - `service_sid` string, nullable
  - `friendly_name` string, nullable
  - `type` 'channel' | 'deployment'
  - `permissions` string[], nullable
  - `date_created` string, date-time, nullable
  - `date_updated` string, date-time, nullable
  - `url` string, uri, nullable

## Changes

- **2023-08-10** (v2) `03de90f08481`: 1 info
  - api tag `IpMessagingV2Role` added

[Operation history](https://skmtc.dev/twilio/apis/twilio-ip-messaging/changes/v2/Services/:ServiceSid/Roles/post.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-ip-messaging.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-ip-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-ip-messaging/revisions/548426606af4?raw)