Twilio

Overview

Use Twilio credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	twilio
Category	Communication
Credential Type	Basic Auth

Step 1: Get Credentials

Log in to the Twilio Console

Log in to the Twilio Console at console.twilio.com.

Find credentials

Your Account SID and Auth Token are on the main dashboard.

Copy the Account SID

Copy the Account SID for the credential field.

Copy the Auth Token

Copy the Auth Token for the Auth Token field.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Twilio

Go to Managed Secrets > Add Provider > Twilio.

Enter credentials

Paste your Account SID and Auth Token into their respective fields.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.POST,
    "https://api.twilio.com/2010-04-01/Accounts/YOUR_ACCOUNT_SID/Messages.json",
    grant_id="YOUR_GRANT_ID",
    extra_headers={"Content-Type": "application/x-www-form-urlencoded"},
    body=b"To=%2B15551234567&From=%2B15557654321&Body=Hello%20from%20Alter",
)

Notes

• Treat your Auth Token like a password — it grants full access to your Twilio account. Never share it or commit it to source control.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
CreateMessage	send	POST	/2010-04-01/Accounts/{AccountSid}/Messages.json
ListMessage	read	GET	/2010-04-01/Accounts/{AccountSid}/Messages.json
CreateCall	send	POST	/2010-04-01/Accounts/{AccountSid}/Calls.json
ListCall	read	GET	/2010-04-01/Accounts/{AccountSid}/Calls.json
CreateParticipant	send	POST	/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants.json
CreatePayments	payment	POST	/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Payments.json
CreateMessageFeedback	write	POST	/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Feedback.json
FetchBalance	read	GET	/2010-04-01/Accounts/{AccountSid}/Balance.json
CreateAccount	admin	POST	/2010-04-01/Accounts.json
CreateIncomingPhoneNumber	admin, payment	POST	/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json
ListIncomingPhoneNumber	read	GET	/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json
CreateNewKey	admin	POST	/2010-04-01/Accounts/{AccountSid}/Keys.json
CreateNewSigningKey	admin	POST	/2010-04-01/Accounts/{AccountSid}/SigningKeys.json
ListRecording	read	GET	/2010-04-01/Accounts/{AccountSid}/Recordings.json
ListUsageRecord	read	GET	/2010-04-01/Accounts/{AccountSid}/Usage/Records.json
CreateQueue	write	POST	/2010-04-01/Accounts/{AccountSid}/Queues.json
CreateUsageTrigger	write	POST	/2010-04-01/Accounts/{AccountSid}/Usage/Triggers.json