Skip to main content

Twilio

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Twilio account to Nirvai to send SMS messages, make voice calls, and manage communications programmatically.

Supported Authentication Methods​

  • Basic Auth - Account SID + Auth Token

Prerequisites​

  • A Twilio account (Sign up free)
  • A Twilio phone number (for sending SMS/making calls)

Setup Instructions​

Getting Your Credentials​

  1. Log in to the Twilio Console
  2. On the Console Dashboard, find the Account Info section
  3. Locate your credentials:
    • Account SID: Starts with AC... (34 characters)
    • Auth Token: Click "Show" to reveal it
  4. In Nirvai, create a new Twilio credential:
    • Username/Account SID: Paste your Account SID
    • Password/Auth Token: Paste your Auth Token

Using API Keys (Alternative)​

For enhanced security, you can create API Keys instead of using the main Auth Token:

  1. Go to Account > API Keys
  2. Click Create API Key
  3. Choose key type (Standard or Main)
  4. Note your SID and Secret (shown only once)
  5. Use API Key SID as username and Secret as password

Account Types​

TypeDescription
Trial AccountFree, limited to verified numbers
Full AccountPaid, can send to any number

Trial accounts can only send messages to verified phone numbers. Upgrade to remove this limitation.

Troubleshooting​

Common Issues​

  • 401 Unauthorized: Check Account SID and Auth Token are correct.
  • Trial account limitation: Trial accounts can only send to verified numbers.
  • Geographic permissions: Some countries require enabling in Console > Phone Numbers > Geographic Permissions.
  • Invalid phone number format: Use E.164 format (e.g., +1234567890).

Error Codes​

CodeMeaning
20003Authentication failed
21211Invalid 'To' phone number
21608Unverified destination (trial accounts)
21610Number blocked (opted out)

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.