Twilio

The Twilio toolkit connects Arcade to the Twilio Messaging API, enabling LLMs to send SMS messages and read inbound/outbound SMS conversations through Twilio phone numbers.

Capabilities

• Send SMS — send outbound SMS from any SMS-capable Twilio number on the account; returns the message SID and delivery status. Trial accounts are limited to verified destination numbers.
• Read conversations — retrieve the full two-way SMS thread with a specific contact (messages sent and received), paginated newest-first with cursor support.
• Inspect received messages — list inbound SMS on a given Twilio number, newest first, with cursor-based pagination.
• Discover phone numbers — enumerate SMS-capable phone numbers on the account in ascending order, with cursor-based pagination.

Secrets

All three secrets are required. Together they authenticate via Twilio's API Key credentials (preferred over the primary auth token).

• TWILIO_ACCOUNT_SID — the unique identifier for your Twilio account. Find it on the Twilio Console home page in the "Account Info" panel. It starts with AC.

• TWILIO_API_KEY_SID — the SID of a Twilio API Key, which acts as a username for API requests. Create one in the Twilio Console under Account → API keys & tokens → Create API key. Choose "Standard" type unless you need a Main key. The SID is displayed immediately after creation and starts with SK. Store it; it is shown only once in full context.

• TWILIO_API_KEY_SECRET — the secret associated with the API Key above, analogous to a password. It is shown only at creation time on the same page in the Twilio Console. Copy and store it immediately — Twilio does not expose it again. If lost, delete the key and create a new one. See Twilio's API Keys documentation for full details.

For guidance on storing secrets in Arcade, see the Arcade secrets documentation. You can manage stored secrets at https://api.arcade.dev/dashboard/auth/secrets.