> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio

> How to set up the Twilio connector, plus the actions and events that are available.

![Twilio](https://stackone-logos.com/api/twilio/filled/svg)

v2.3.1[See changelog](https://docs.stackone.com/connectors/twilio/changelog.md)

[59 actions](#actions) · [20 events](#events) · 4 auth methods

Messaging
Telephony
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Auth Token · Connector Profile](https://docs.stackone.com/connectors/twilio/guides/connector-profile/auth-token.md)
>
> Your primary account credentials. Provides full access to all Twilio resources under your account.

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/twilio/guides/connector-profile/api-key.md)
>
> Recommended for production. API keys can be independently rotated and revoked without affecting your main credentials.

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/twilio/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> Requires creating an OAuth app in the Twilio Console. Access tokens expire after 1 hour and are automatically refreshed.

> [card] [Organizations API — OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/twilio/guides/connector-profile/organizations-api-oauth-2-0-client-credentials.md)
>
> Required for the unified IAM actions (users, roles, organizations, /me), which call Twilio's Organization-level Role and...

Optionally, configure receiving Events for Twilio into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/twilio/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Auth Token · Link Account](https://docs.stackone.com/connectors/twilio/guides/link-account/auth-token.md)

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/twilio/guides/link-account/api-key.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/twilio/guides/link-account/oauth-2-0-client-credentials.md)

> [card] [Organizations API — OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/twilio/guides/link-account/organizations-api-oauth-2-0-client-credentials.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Key

Auth Token

OAuth 2.0 (Client Credentials)

Organizations API — OAuth 2.0 (Client Credentials)

No auth methods found

Scopes

Select all
|
Clear

conversations-classic.conversations:create

conversations-classic.conversations:delete

conversations-classic.conversations:list

conversations-classic.conversations:read

conversations-classic.conversations:update

conversations-classic.messages:create

conversations-classic.messages:delete

conversations-classic.messages:list

conversations-classic.messages:read

conversations-classic.messages:update

conversations-classic.participants:create

conversations-classic.participants:delete

conversations-classic.participants:list

conversations-classic.participants:read

conversations-classic.participants:update

conversations-classic.users.conversations:list

conversations-classic.users:create

conversations-classic.users:delete

conversations-classic.users:list

conversations-classic.users:read

conversations-classic.users:update

conversations-classic.webhooks:list

event-streams.event-type:list

event-streams.event-type:read

event-streams.sink:create

event-streams.sink:delete

event-streams.sink:list

event-streams.sink:read

event-streams.subscription.subscribed-event:list

event-streams.subscription:create

event-streams.subscription:delete

event-streams.subscription:list

event-streams.subscription:read

iam.accounts:list

iam.accounts:read

iam.roles:list

messaging.messages.media:delete

messaging.messages.media:list

messaging.messages.media:read

messaging.messages:create

messaging.messages:delete

messaging.messages:list

messaging.messages:read

messaging.messages:update

voice.calls.recordings:list

voice.calls:create

voice.calls:delete

voice.calls:list

voice.calls:read

voice.calls:update

No scopes found

59 actions

ActionDescriptionRequired scopes

List Messages`twilio_list_messages`

List all messages sent or received by your Twilio account

`messaging.messages:list`

Get Message`twilio_get_message`

Retrieve details of a specific message by SID

`messaging.messages:read`

Create Message`twilio_create_message`

Create a new SMS or MMS message

`messaging.messages:create`

Update Message`twilio_update_message`

Update a message (redact message body or cancel scheduled message)

`messaging.messages:update`

Delete Message`twilio_delete_message`

Delete a message record

`messaging.messages:delete`

List Message Media`twilio_list_message_media`

List all media associated with a message

`messaging.messages.media:list`

Get Message Media`twilio_get_message_media`

Retrieve details of a specific media item attached to a message

`messaging.messages.media:read`

Delete Message Media`twilio_delete_message_media`

Delete a specific media instance

`messaging.messages.media:delete`

List Calls`twilio_list_calls`

List all calls made to and from your Twilio account

`voice.calls:list`

Get Call`twilio_get_call`

Retrieve details of a specific call by SID

`voice.calls:read`

Make Call`twilio_create_call`

Initiate an outbound call

`voice.calls:create`

Update Call`twilio_update_call`

Modify an in-progress call (redirect, cancel, or complete)

`voice.calls:update`

Delete Call`twilio_delete_call`

Delete a call record

`voice.calls:delete`

List Call Recordings`twilio_list_call_recordings`

List all recordings for a specific call

`voice.calls.recordings:list`

Get Account`twilio_get_account`

Retrieve account information and current status

`iam.accounts:read`

List Accounts`twilio_list_accounts`

List all accounts including the main account and subaccounts

`iam.accounts:list`

Create Account`twilio_create_account`

Create a new account under the main account

Update Account`twilio_update_account`

Update account properties (friendly name or status)

List Conversations`twilio_list_conversations`

List all conversations in your account

`conversations-classic.conversations:list`

Get Conversation`twilio_get_conversation`

Retrieve details of a specific conversation by SID

`conversations-classic.conversations:read`

Create Conversation`twilio_create_conversation`

Create a new conversation

`conversations-classic.conversations:create`

Update Conversation`twilio_update_conversation`

Update an existing conversation

`conversations-classic.conversations:update`

Delete Conversation`twilio_delete_conversation`

Delete a conversation

`conversations-classic.conversations:delete`

List Conversation Messages`twilio_list_conversation_messages`

List all messages in a conversation

`conversations-classic.messages:list`

Get Conversation Message`twilio_get_conversation_message`

Retrieve details of a specific message in a conversation

`conversations-classic.messages:read`

Create Conversation Message`twilio_create_conversation_message`

Create a new message in a conversation

`conversations-classic.messages:create`

Update Conversation Message`twilio_update_conversation_message`

Update an existing message in a conversation

`conversations-classic.messages:update`

Delete Conversation Message`twilio_delete_conversation_message`

Delete a message from a conversation

`conversations-classic.messages:delete`

List Conversation Participants`twilio_list_conversation_participants`

List all participants in a conversation

`conversations-classic.participants:list`

Get Conversation Participant`twilio_get_conversation_participant`

Retrieve details of a specific participant in a conversation

`conversations-classic.participants:read`

Create Conversation Participant`twilio_create_conversation_participant`

Create a new participant in a conversation

`conversations-classic.participants:create`

Update Conversation Participant`twilio_update_conversation_participant`

Update a participant in a conversation

`conversations-classic.participants:update`

Delete Conversation Participant`twilio_delete_conversation_participant`

Delete a participant from a conversation

`conversations-classic.participants:delete`

List Conversation Users`twilio_list_conversation_users`

List all users in the conversations service

`conversations-classic.users:list`

Get Conversation User`twilio_get_conversation_user`

Retrieve details of a specific user

`conversations-classic.users:read`

Create Conversation User`twilio_create_conversation_user`

Create a new user in the conversations service

`conversations-classic.users:create`

Update Conversation User`twilio_update_conversation_user`

Update an existing user

`conversations-classic.users:update`

Delete Conversation User`twilio_delete_conversation_user`

Delete a user from the conversations service

`conversations-classic.users:delete`

List Conversation Webhooks`twilio_list_conversation_webhooks`

List all webhooks configured for a specific conversation

`conversations-classic.webhooks:list`

List User Conversations`twilio_list_user_conversations`

List all conversations a specific user belongs to

`conversations-classic.users.conversations:list`

Get Unified Credentials`twilio_unified_get_me`

Get the current Twilio Organizations connection's unified credentials and identity.

`iam.roles:list`

IAM Auth Test`twilio_auth_test`

Validate the current OAuth client\_credentials token against the Twilio Organizations API and return the raw, unmapped Ro...

`iam.roles:list`

List Unified Organizations`twilio_unified_list_organizations`

List unified organizations for the connected Twilio account.

`iam.roles:list`

Get Unified Organization`twilio_unified_get_organization`

Get a unified Twilio organization by ID.

`iam.roles:list`

List Unified Roles`twilio_unified_list_roles`

List unified roles in the connected Twilio Organization.

`iam.roles:list`

Get Unified Role`twilio_unified_get_role`

Get a unified Twilio Organization role by ID.

`iam.roles:list`

List Unified Users`twilio_unified_list_users`

List unified users in the connected Twilio Organization.

Get Unified User`twilio_unified_get_user`

Get a unified Twilio Organization user by ID.

Create Event Sink`twilio_create_event_sink`

Create a new Event Streams Sink (webhook destination) to receive Twilio events.

`event-streams.sink:create`

Get Event Sink`twilio_get_event_sink`

Retrieve details of a specific Event Streams Sink by SID.

`event-streams.sink:read`

List Event Sinks`twilio_list_event_sinks`

List all Event Streams Sinks in the Twilio account.

`event-streams.sink:list`

Delete Event Sink`twilio_delete_event_sink`

Delete an Event Streams Sink. The Sink must not be referenced by any active Subscriptions.

`event-streams.sink:delete`

Create Event Subscription`twilio_create_event_subscription`

Create a new Event Streams Subscription to link event types to a Sink.

`event-streams.subscription:create`

Get Event Subscription`twilio_get_event_subscription`

Retrieve details of a specific Event Streams Subscription by SID.

`event-streams.subscription:read`

List Event Subscriptions`twilio_list_event_subscriptions`

List all Event Streams Subscriptions in the Twilio account.

`event-streams.subscription:list`

Delete Event Subscription`twilio_delete_event_subscription`

Delete an Event Streams Subscription. Events will stop being delivered to the associated Sink.

`event-streams.subscription:delete`

List Subscribed Events`twilio_list_subscribed_events`

List all event types subscribed under a specific Subscription.

`event-streams.subscription.subscribed-event:list`

List Event Types`twilio_list_event_types`

List all available Twilio Event Streams event types.

`event-streams.event-type:list`

Get Event Type`twilio_get_event_type`

Retrieve details of a specific Event Streams event type.

`event-streams.event-type:read`

## Events

Tags

Select all
|
Clear

Calls

Conversations

Messages

Participants

Users

Webhooks

No tags found

20 events

EventDescriptionTags

Test Event`twilio_webhook_test_event`

Responds to Twilio Event Streams test events sent when validating a Sink endpoint.

Webhooks

Message Delivered`twilio_webhook_message_delivered`

Emitted when an outbound message is successfully delivered to the recipient.

MessagesWebhooks

Message Sent`twilio_webhook_message_sent`

Emitted when an outbound message is accepted and queued by Twilio for delivery.

MessagesWebhooks

Message Failed`twilio_webhook_message_failed`

Emitted when an outbound message fails to deliver and will not be retried.

MessagesWebhooks

Inbound Message Received`twilio_webhook_inbound_message_received`

Emitted when a message is received by a Twilio phone number or messaging resource.

MessagesWebhooks

Call Summary Complete`twilio_webhook_call_summary_complete`

Emitted when a voice call summary is available via Twilio Voice Insights.

CallsWebhooks

Call Initiated`twilio_webhook_call_initiated`

Emitted when an outbound call is initiated.

CallsWebhooks

Call Ringing`twilio_webhook_call_ringing`

Emitted when an outbound call starts ringing at the destination.

CallsWebhooks

Call Answered`twilio_webhook_call_answered`

Emitted when a voice call is answered.

CallsWebhooks

Call Completed`twilio_webhook_call_completed`

Emitted when a voice call ends.

CallsWebhooks

Conversation Added`twilio_webhook_conversation_added`

Emitted when a new Twilio Conversation is created.

ConversationsWebhooks

Conversation Updated`twilio_webhook_conversation_updated`

Emitted when a Twilio Conversation is updated (attributes, friendly name, etc.).

ConversationsWebhooks

Conversation Removed`twilio_webhook_conversation_removed`

Emitted when a Twilio Conversation is deleted.

ConversationsWebhooks

Conversation State Updated`twilio_webhook_conversation_state_updated`

Emitted when a Twilio Conversation state changes (active, inactive, closed).

ConversationsWebhooks

Conversation Message Added`twilio_webhook_conversation_message_added`

Emitted when a new message is added to a Twilio Conversation.

ConversationsMessagesWebhooks

Conversation Message Updated`twilio_webhook_conversation_message_updated`

Emitted when a message in a Twilio Conversation is updated.

ConversationsMessagesWebhooks

Conversation Message Removed`twilio_webhook_conversation_message_removed`

Emitted when a message is removed from a Twilio Conversation.

ConversationsMessagesWebhooks

Conversation Participant Added`twilio_webhook_conversation_participant_added`

Emitted when a participant joins a Twilio Conversation.

ConversationsParticipantsWebhooks

Conversation Participant Removed`twilio_webhook_conversation_participant_removed`

Emitted when a participant leaves or is removed from a Twilio Conversation.

ConversationsParticipantsWebhooks

Conversation User Updated`twilio_webhook_conversation_user_updated`

Emitted when a Conversations user's properties are updated.

ConversationsUsersWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.