airbyte/docs/integrations/sources/twilio.md

Twilio

This page contains the setup guide and reference information for the Twilio source connector.

Prerequisites

Twilio HTTP requests to the REST API are protected with HTTP Basic authentication. In short, you will use your Twilio Account SID as the username and your Auth Token as the password for HTTP Basic authentication.

You can find your Account SID and Auth Token on your dashboard.

See docs for more details.

Setup guide

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the Twilio connector and select Twilio from the <Source/Destination> type dropdown.
4. Enter your account_sid.
5. Enter your auth_token.
6. Enter your start_date.
7. Enter your lookback_window.
8. Click Set up source.

For Airbyte Open Source:

1. Navigate to the Airbyte Open Source dashboard.
2. Set the name for your source.
3. Enter your account_sid.
4. Enter your auth_token.
5. Enter your start_date.
6. Enter your lookback_window.
7. Click Set up source.

Supported sync modes

The Twilio source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	Yes
Replicate Incremental Deletes	No
SSL connection	Yes
Namespaces	No

Supported Streams

• Accounts
• Addresses
• Alerts (Incremental)
• Applications
• Available Phone Number Countries (Incremental)
• Available Phone Numbers Local (Incremental)
• Available Phone Numbers Mobile (Incremental)
• Available Phone Numbers Toll Free (Incremental)
• Calls (Incremental)
• Conference Participants (Incremental)
• Conferences (Incremental)
• Conversations
• Conversation Messages
• Conversation Participants
• Dependent Phone Numbers (Incremental)
• Executions (Incremental)
• Incoming Phone Numbers (Incremental)
• Flows
• Keys
• Message Media (Incremental)
• Messages (Incremental)
• Outgoing Caller Ids
• Queues
• Recordings (Incremental)
• Services
• Roles
• Transcriptions
• Trunks
• Usage Records (Incremental)
• Usage Triggers
• Users
• UserConversations
• VerifyServices

Performance considerations

The Twilio connector will gracefully handle rate limits. For more information, see the Twilio docs for rate limitations.

Changelog

Version	Date	Pull Request	Subject
0.9.0	2023-06-27	27221	Add new stream UserConversations with parent Users
0.8.1	2023-07-12	28216	Add property channel_metadata to ConversationMessages schema
0.8.0	2023-06-11	27231	Add new stream VerifyServices
0.7.0	2023-05-03	25781	Add new stream Trunks
0.6.0	2023-05-03	25783	Add new stream Roles with parent Services
0.5.0	2023-03-21	23995	Add new stream Conversation Participants
0.4.0	2023-03-18	23995	Add new stream Conversation Messages
0.3.0	2023-03-18	22874	Add new stream Executions with parent Flows
0.2.0	2023-03-16	24114	Add Conversations stream
0.1.16	2023-02-10	22825	Specified date formatting in specification
0.1.15	2023-01-27	22025	Set AvailabilityStrategy for streams explicitly to None
0.1.14	2022-11-16	19479	Fix date range slicing
0.1.13	2022-10-25	18423	Implement datetime slicing for streams supporting incremental syncs
0.1.11	2022-09-30	17478	Add lookback_window parameters
0.1.10	2022-09-29	17410	Migrate to per-stream states
0.1.9	2022-09-26	17134	Add test data for Message Media and Conferences
0.1.8	2022-08-29	16110	Add state checkpoint interval
0.1.7	2022-08-26	15972	Shift start date for stream if it exceeds 400 days
0.1.6	2022-06-22	14000	Update Records stream schema and align tests with connectors' best practices
0.1.5	2022-06-22	13896	Add lookback window parameters to fetch messages with a rolling window and catch status updates
0.1.4	2022-04-22	12157	Use Retry-After header for backoff
0.1.3	2022-04-20	12183	Add new subresource on the call stream + declare a valid primary key for conference_participants stream
0.1.2	2021-12-23	9092	Correct specification doc URL
0.1.1	2021-10-18	7034	Update schemas and transform data types according to the API schema
0.1.0	2021-07-02	4070	Native Twilio connector implemented