Chartmogul

Availability:

Airbyte Cloud Airbyte OSS PyAirbyte

Support Level:

community

Connector Version:

1.0.1

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

Prerequisites

• A Chartmogul API Key.
• A desired start date from which to begin replicating data.

Setup guide

Step 1: Set up a Chartmogul API key

1. Log in to your Chartmogul account.
2. In the left navbar, select Profile > View Profile.
3. Select NEW API KEY.
4. In the Name field, enter a unique name for the key.
5. If you are a Staff, Admin, or Owner, set the Access Level to either Read-only or Read & Write using the dropdown menu. We recommend Read-only.
6. Click ADD to create the key.
7. Click the Reveal icon to see the key, and the Copy icon to copy it to your clipboard.

For further reading on Chartmogul API Key creation and maintenance, please refer to the official Chartmogul documentation.

Step 2: Set up the Chartmogul connector in Airbyte

1. Log in to your Airbyte Cloud account, or navigate to the Airbyte Open Source dashboard.
2. From the Airbyte UI, click Sources, then click on + New Source and select Chartmogul from the list of available sources.
3. Enter a Source name of your choosing.
4. Enter the API key that you obtained.
5. Enter a Start date. If you are configuring this connector programmatically, please format the date as such: yyyy-mm-ddThh:mm:ssZ. For example, an input of 2017-01-25T06:30:00Z will signify a start date of 6:30 AM UTC on January 25th, 2017. When feasible, any data before this date will not be replicated.

note

The Start date will only apply to the Activities stream. The Customers endpoint does not provide a way to filter by the creation or update dates.

6. Click Set up source and wait for the tests to complete.

Supported sync modes

The Chartmogul source connector supports the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append

Supported streams

This connector outputs the following full refresh streams:

• Activities
• CustomerCountDaily
• CustomerCountWeekly
• CustomerCountMonthly
• CustomerCountQuarterly
• Customers

Performance considerations

The Chartmogul connector should not run into Chartmogul API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

Reference

Config fields reference

Field

Type

Property name

string

api_key

string

start_date

Changelog

Version	Date	Pull Request	Subject
1.0.1	2024-05-14	38145	Make connector compatible with builder
1.0.0	2023-11-09	23075	Refactor CustomerCount stream into CustomerCountDaily, CustomerCountWeekly, CustomerCountMonthly, CustomerCountQuarterly Streams
0.2.1	2023-02-15	23075	Specified date formatting in specification
0.2.0	2022-11-15	19276	Migrate connector from Alpha (Python) to Beta (YAML)
0.1.1	2022-03-02	10756	Add new stream: customer-count
0.1.0	2022-01-10	9381	New Source: Chartmogul