Objective
This article helps you create a new Twilio API key so your application can authenticate to the Twilio API without using your account auth token, and shows you where to copy the key's secret before it becomes unavailable.
Product
Twilio Console
Environment
Twilio Console
User Account Permission/Role(s) Required
An account role that allows you to create API keys. If your role does not include it, the Create API key action is not shown.
Procedure
- In the Twilio Console, select Builder tools in the left sidebar.
- Select API Key & creds, then API Keys & auth tokens.
- On the API keys tab, select Create API key.
- On the API key details step, enter an API key name.
- Choose a Key type: Main, Standard, or Restricted.
- If you chose Restricted, the Permissions section appears. Use Expand All to open the product groups, or search by product or resource, then select the permissions the key should have. You must select at least one.
- Select Next. Twilio creates the key and moves you to the Copy secret step.
- Copy the SID and Client secret values and store them somewhere safe.
- Select the checkbox confirming that you have saved your Client ID and Client secret, then select Finish. You are returned to the API keys list.
Additional Information
- The secret is shown only on the Copy secret step. You cannot retrieve it later, and Finish stays blocked until you confirm you have saved it, the form reports "Acknowledgement is required to continue".
- The API key name is required and is limited to 64 characters.
- In the United States region the key type defaults to Restricted and the Permissions section is shown straight away. In other regions the type defaults to Standard and cannot be changed, because restricted keys are only available in the United States region.
- If you leave the wizard with unsaved entries, a confirmation dialog appears; select Close without saving to discard them.
- Searching the permissions table for a term with no matches shows "No results found".
This content was generated by AI and reviewed, edited, and verified by a human.