What's NewCloudZero Academy
Guides
CloudZero Status

Connecting to Twilio

How the Twilio Connection works

The Twilio connection uses a Twilio API Key to ingest daily usage records and account metadata for your organization. In CloudZero, you can view, track, and forecast your Twilio costs broken down by account and sub-account, product family (Voice, SMS, MMS, Verify, and more), category, and date. Twilio's usage is reported daily — this is the most detailed view Twilio provides.

Supported Twilio Accounts

This connection works with Twilio main accounts. Sub-accounts owned by the main account are included automatically.

⚠️

Twilio SendGrid is not included. SendGrid is a Twilio subsidiary that is billed separately and is not in scope for this connection.

Prerequisites for the Twilio Connection

Before you can connect CloudZero to Twilio, you must have the following:

  1. Your Twilio Account SID (starts with AC), available on the main account page in the Twilio Console.
  2. A Twilio API Key SID (starts with SK) and its Secret. Use either a Main key or a Restricted key — see Step 2 for the required scopes. Standard API keys are not sufficient — they cannot read sub-account information, which CloudZero needs.
ℹ️

CloudZero connects to Twilio with a revocable API Key (SID and Secret). Do not enter your Twilio Auth Token — it is not used by this connection.

To connect CloudZero to Twilio, complete the following steps:

  1. Copy your Account SID.
  2. Create an API Key in Twilio.
  3. Create the Twilio connection in CloudZero.

Step 1: Copy your Account SID

  1. Sign in to the Twilio Console.
  2. From the main account page, copy your Account SID (starts with AC) and save it for later.

Step 2: Create an API Key in Twilio

  1. In the Twilio Console, navigate to Settings > Account settings > API keys & auth tokens, or open the API Keys page directly.
  2. Select Create API key and provide a descriptive name, for example, CloudZero Integration.
  3. Choose a key type:
    • Main — full account access; the simplest option if your security policy allows it.
    • Restricted — least-privilege. Grant Usage Records Permissions (Billing/Usage) and Identity and Access Management (IAM) Permissions (Accounts).
  4. Select Create API Key.
  5. Copy the Key SID (starts with SK) and the Secret immediately and store them securely. Twilio displays the Secret only once.

Step 3: Create the Twilio Connection in CloudZero

  1. In CloudZero, navigate to Cloud Integrations and select Add Connection.
  2. Select the Twilio tile and select Get Started.
  3. Enter a connection name.
  4. Enter your Account SID, API Key SID, and API Key Secret.
  5. Select Connect.

After CloudZero has processed the first ingest, the connection Status will change from Pending Data to Healthy.

Updated 2 days ago