Connect Twilio

Twilio is a cloud communications platform providing APIs for SMS, voice, video, and authentication. The Twilio integration imports your daily usage and cost data into DoiT Cloud Intelligence so you can analyze Twilio spending in Cloud Analytics.

Prerequisites

• A Twilio account with Administrator or Developer role.
• A DoiT account with the Billing Profiles Admin permission.

Required credentials

Field	Description	Where to find it
Account SID	Your Twilio account identifier (starts with AC)	Twilio console → Account Dashboard → Account Info
Account Name	A display name for this account in reports	You choose this name (recommended: use your Twilio account name)
API Credentials	API key SID and secret in api_key_sid:api_secret format	Create at Twilio console → Admin → Account management → API keys & tokens

Create a Standard API key

1. Sign in to the Twilio console.

2. Navigate to Admin → Account management → API keys & tokens.

3. Select Create API key.

4. For Key type, select Standard.

5. Enter a friendly name (e.g. doit-integration).

6. Select Create.

7. Copy the SID and Secret, and combine them as api_key_sid:api_secret.

   Caution

   The secret is only shown once. Make sure to copy it before closing the page.

Connect your Twilio account

1. Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations → Assets.

2. Select Twilio from the left-hand menu, and then select Connect new account.

3. Enter your Account SID, Account Name, and API Credentials (in api_key_sid:api_secret format).

4. Select Test connection to verify DoiT can access your Twilio data.

5. If the test is successful, select Save to complete the setup.

   If the test fails or you need further assistance, please open an expert inquiry.

Note

Upon initial connection, DoiT ingests your historical usage data. The import process can take a few hours. You'll receive an email when the data is available in Cloud Analytics.

Data refresh

DoiT refreshes your Twilio data daily. Data typically becomes available within 48 hours of being generated by Twilio.

Reporting dimensions

Once connected, Twilio data maps to the following standard Cloud Analytics dimensions:

Cloud Analytics dimension	Twilio value	Example
Provider	Twilio	Twilio
Billing Account	Account SID	ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Project/Account ID	Account SID	ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Service	Usage category	sms, calls, phonenumbers
SKU	Usage description	SMS - Outbound, Calls - Inbound

In addition to standard dimensions, the following Twilio-specific labels are available:

Label	Description
Category	Twilio usage category (e.g. sms, calls, recordings)
Billing Account	The display name you provided for this account
Service	High-level usage group (Messaging, Voice, Phone Numbers, etc.)

Delete your Twilio connection

1. Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations → Assets.

2. Select Twilio from the left-hand menu.

3. Select the three dots menu (⋮) at the rightmost end of the account you want to remove and select Delete.

4. Select Delete to confirm.