Skip to main content


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


  • Secret Key
  • Start Day
  • Lookback Window

Setup guide

Step 1: Set up Paystack connector

  1. Log into your Airbyte Cloud or Airbyte Open Source account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Paystack from the Source type dropdown.
  4. Enter a name for your source.
  5. For Secret Key enter your secret key. The Paystack API key usually starts with 'sklive'. You can find yours secret key here.
  6. For Start Date enter UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated.
  7. For Lookback Window (in days) enter the number of days. When set, the connector will always reload data from the past N days, where N is the value set here. This is useful if your data is updated after creation.

Supported sync modes

The Paystack source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Supported Streams

Note on Incremental Syncs

The Paystack API does not allow querying objects which were updated since the last sync. Therefore, this connector uses the createdAt field to query for new data in your Paystack account.

If your data is updated after creation, you can use the Loockback Window option when configuring the connector to always reload data from the past N days. This will allow you to pick up updates to the data.

Data type map

The Paystack API is compatible with the JSONSchema types that Airbyte uses internally (string, date-time, object, array, boolean, integer, and number), so no type conversions happen as part of this source.


Full Refresh SyncYes
Incremental - Append SyncYes
Incremental - Dedupe SyncYes
SSL connectionYes

Performance considerations

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


Config fields reference

Property name


VersionDatePull RequestSubject
0.1.32023-03-2124247Specified date formatting in specification
0.1.22023-03-1524085Set additionalProperties: true, add TypeTransformer to Refunds
0.1.12021-12-078582Update connector fields title/description
0.1.02021-10-207214Add Paystack source connector