Skip to main content

Chartmogul

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.

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

Supported sync modes

The Chartmogul source connector supports the following sync modes:

Supported streams

This connector outputs the following full refresh streams:

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

VersionDatePull RequestSubject
1.0.02023-11-0923075Refactor CustomerCount stream into CustomerCountDaily, CustomerCountWeekly, CustomerCountMonthly, CustomerCountQuarterly Streams
0.2.12023-02-1523075Specified date formatting in specification
0.2.02022-11-1519276Migrate connector from Alpha (Python) to Beta (YAML)
0.1.12022-03-0210756Add new stream: customer-count
0.1.02022-01-109381New Source: Chartmogul