smsmode RCS
Sync RCS message logs and monthly consumption data from your smsmode account. The smsmode RCS source connector reads from smsmode RCS API and smsmode Commons API.
This connector reads RCS data only. To sync SMS data, use the smsmode SMS connector.
Prerequisites
- A smsmode account with RCS enabled.
- A smsmode API key. See Get your API key.
Setup
Get your API key
The connector authenticates each request using an API key in the X-Api-Key header.
Create and manage API keys with the smsmode Credential API. Each key has a role that determines which messages the connector can read:
- User: messages sent or received through the user’s own channels.
- Manager: messages for the whole organisation.
- Administrator: messages for the organisation and its sub-organisations.
Create a key with a role covering every RCS channel you want to sync. You can revoke one key without affecting other account keys.
Set up the connector
- In the Airbyte UI, create a new source and select smsmode RCS.
- Enter a name for the source.
- Paste your smsmode API key into API Key.
- Click Set up source.
Supported sync modes
Both streams support Full Refresh only. They don’t support incremental syncs.
Each sync returns a fixed lookback window: 30 days of messages and 12 months of consumption. A Full Refresh | Overwrite sync replaces older destination data with the latest window only. To retain a longer history, use Full Refresh | Append and deduplicate records in your destination.
Supported streams
| Stream | Source endpoint | What it returns |
|---|---|---|
rcs_messages | GET /rcs/v1/messages | RCS message logs from the last 30 days, including both directions. |
consumptions_rcs | GET /commons/v1/consumptions | Monthly RCS consumption records for the last 12 months. |
rcs_messages
Get message logs for a rolling 30-day window ending at sync time in UTC. You can’t configure this window.
The connector requests each direction separately, then merges the results into one stream:
- MT (Mobile Terminated): messages your account sent to recipients.
- MO (Mobile Originated): messages recipients sent to your RCS agent.
Each record includes a direction field containing MT or MO. Use this field to distinguish the directions downstream.
The connector retries failed requests to this endpoint up to 5 times, using exponential backoff.
consumptions_rcs
Get one RCS consumption record per month, starting 365 days before the sync date. The connector filters the Commons consumption endpoint to periodType=MONTH and channel.type=RCS. The results exclude daily breakdowns and SMS consumption.
Limitations
- The connector fixes the message window at 30 days and the consumption window at 12 months. To backfill older data, export it directly from smsmode.
- Neither stream defines a primary key, so Airbyte can’t deduplicate records for you.
- The connector pages through results in groups of 100 records. This is the maximum page size allowed by the smsmode API.
- smsmode doesn’t publish rate limits for these endpoints.
Reference
Configuration
| Input | Type | Description | Default Value |
|---|---|---|---|
api_key | string | API Key. Your smsmode API key, created with the Credential API. |
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.8 | 2026-11-10 | 91730 | Update dependencies |
| 0.0.7 | 2026-11-03 | 90757 | Update dependencies |
| 0.0.6 | 2026-10-20 | 89425 | Update dependencies |
| 0.0.5 | 2026-10-13 | 88777 | Update dependencies |
| 0.0.4 | 2026-10-06 | 88065 | Update dependencies |
| 0.0.3 | 2026-09-29 | 87384 | Update dependencies |
| 0.0.2 | 2026-09-22 | 86828 | Update dependencies |
| 0.0.1 | 2026-09-16 | 79710 | Initial release by @CaladeTechnologies via Connector Builder. Syncs a rolling 30-day window of rcs_messages across MT and MO directions, and monthly consumptions_rcs. |