Skip to contentSkip to navigationSkip to topbar
On this page

Restricted API keys


(information)

Public Beta Notice

Restricted API keys are available as a public beta release. Twilio might add or change features before declaring Restricted API keys Generally Available. Beta products aren't covered by a Twilio SLA.

Learn more about beta product support(link takes you to an external page).

Use Restricted API keys for fine-grained control over access to Twilio API resources. You can create and manage Restricted API keys using the REST API Key resource v1 or the Twilio Console(link takes you to an external page).

Restricted API keys allow you to grant API access to many Twilio API endpoints, including:

For example, if your Programmable Voice application's testing suite makes test Voice calls, you can create a Restricted API key that permits only sending POST requests to create Call Resources.

Or you can create Restricted API keys that provide your engineering team with access to every Voice endpoint except the Call Recording Resource endpoints.

(warning)

Warning

You can't create Access Tokens for Twilio's client-side SDKs with Restricted API keys.


Working with Restricted API keys

working-with-restricted-api-keys page anchor

Create and manage Restricted API keys

create-and-manage-restricted-api-keys page anchor

Authenticate with a Restricted API key

authenticate-with-a-restricted-api-key page anchor

Twilio uses the Restricted key's SID and secret as your credentials when sending API requests.

Read the Requests to Twilio page to learn more.

Permissions available with Restricted API keys

permissions-available-with-restricted-api-keys page anchor
(warning)

Warning

Restricted API keys have a limit of 100 permissions that can be associated with each key.

Restricted API keys allow you grant permissions for keys to access specific API endpoints.

Each permission maps to one or more endpoints/actions for each API Resource.

Click on one of the product areas below to download a PDF of the permissions/endpoint actions.

Twilio Restricted API keys Permissions - Messaging Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - Phone Numbers Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - Studio Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - TaskRouter Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - Voice Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - Lookup Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - API keys Permissions(link takes you to an external page)

Twilio Restricted API keys Permissions - Monitor Permissions(link takes you to an external page)