CallRail
Use this page to set up the CallRail source connector and find reference information.
The connector reads calls, text message conversations, companies and users from the CallRail API v3 for one CallRail account.
Prerequisites
- A CallRail account.
- A CallRail API key. CallRail API keys are scoped to the user who created them. The connector can only read data that this user can see in the CallRail interface. It doesn’t return calls, text messages or companies from accounts or companies the user can’t access. An account administrator can also ask CallRail support to disable API access or restrict it to admin users. For details, see Authorization in the CallRail API documentation.
- Your CallRail account ID. Open the CallRail dashboard in your browser. Copy the nine-digit number that follows
/a/in the URL.
Set up the CallRail connector in Airbyte
- In Airbyte, go to Sources and select CallRail.
- Enter a Source name.
- For API key, enter your CallRail API key.
- For Account ID, enter your nine-digit CallRail account ID.
- For Start date, enter the sync start date in
YYYY-MM-DDformat. The connector only reads records on or after this date. - Click Set up source.
Supported sync modes
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental - Append Sync | Yes |
| Incremental - Dedupe Sync | Yes |
| SSL connection | No |
| Namespaces | No |
Supported streams
| Stream | CallRail endpoint | Primary key | Cursor field |
|---|---|---|---|
calls | Calls | id | start_time |
conversations | Text Messages | id | last_message_at |
companies | Companies | id | created_at |
users | Users | id | created_at |
The conversations stream contains SMS conversations from the CallRail Text Messages endpoint. Each record represents a conversation with one customer. Its recent_messages field contains the most recent messages.
The companies and users streams use created_at as their cursor. Incremental syncs pick up newly created records, but don’t capture changes to existing records. Use a full refresh sync to capture updates to existing companies or users.
Limitations
The connector requests 100 records per page across 100-day windows, from the start date to the current date.
By default, CallRail limits each account to 1,000 general API requests per hour and 10,000 per day. CallRail returns HTTP 429 responses when the connector exceeds these limits. If you reach these limits while syncing extensive historical data, consider a later start date. You can also contact CallRail support to request a higher limit. For details, see Rate Limiting.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.15 | 2026-11-10 | 91325 | Upgrade to source-declarative-manifest 7.47.0 |
| 0.2.14 | 2026-11-10 | 89534 | Migrate acceptance-test-config.yml to the acceptance_tests layout read by the standard tests |
| 0.2.13 | 2025-05-17 | 60647 | Update dependencies |
| 0.2.12 | 2025-05-10 | 59890 | Update dependencies |
| 0.2.11 | 2025-05-03 | 59303 | Update dependencies |
| 0.2.10 | 2025-04-26 | 58699 | Update dependencies |
| 0.2.9 | 2025-04-19 | 58234 | Update dependencies |
| 0.2.8 | 2025-04-12 | 57612 | Update dependencies |
| 0.2.7 | 2025-04-05 | 57161 | Update dependencies |
| 0.2.6 | 2025-03-29 | 56589 | Update dependencies |
| 0.2.5 | 2025-03-22 | 56145 | Update dependencies |
| 0.2.4 | 2025-03-08 | 55415 | Update dependencies |
| 0.2.3 | 2025-03-01 | 54887 | Update dependencies |
| 0.2.2 | 2025-02-22 | 54241 | Update dependencies |
| 0.2.1 | 2025-02-15 | 47584 | Update dependencies |
| 0.2.0 | 2024-08-23 | 44591 | Refactor connector to manifest-only format |
| 0.1.14 | 2024-08-17 | 44240 | Update dependencies |
| 0.1.13 | 2024-08-12 | 43796 | Update dependencies |
| 0.1.12 | 2024-08-10 | 43705 | Update dependencies |
| 0.1.11 | 2024-08-03 | 43173 | Update dependencies |
| 0.1.10 | 2024-07-27 | 42619 | Update dependencies |
| 0.1.9 | 2024-07-20 | 42229 | Update dependencies |
| 0.1.8 | 2024-07-13 | 41788 | Update dependencies |
| 0.1.7 | 2024-07-10 | 41551 | Update dependencies |
| 0.1.6 | 2024-07-09 | 41129 | Update dependencies |
| 0.1.5 | 2024-07-06 | 40833 | Update dependencies |
| 0.1.4 | 2024-06-25 | 40335 | Update dependencies |
| 0.1.3 | 2024-06-22 | 39949 | Update dependencies |
| 0.1.2 | 2024-06-06 | 39281 | [autopull] Upgrade base image to v1.2.2 |
| 0.1.1 | 2024-05-21 | 38531 | [autopull] base image + poetry + up_to_date |
| 0.1.0 | 2022-10-31 | 18739 | 🎉 New Source: CallRail |