ContextQMD
Back to Airbyte

PartnerStack

docs/integrations/sources/partnerstack.md

2.0.08.6 KB
Original Source

PartnerStack

<HideInUI>

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

</HideInUI>

Prerequisites

  • A PartnerStack account with access to the Vendor dashboard
  • PartnerStack API keys (public key and private key)

Setup guide

Step 1: Obtain your PartnerStack API keys

  1. Log in to your PartnerStack Vendor dashboard.
  2. Navigate to Settings > Integrations > PartnerStack API Keys.
  3. Copy your Public key and Private key. The connector uses Basic authentication, where the public key is the username and the private key is the password.

:::note PartnerStack provides separate test and production API keys. Test keys create test customers and do not generate rewards. Use production keys for syncing real data. :::

Step 2: Set up the PartnerStack connector in Airbyte

  1. Enter a name for the PartnerStack connector.
  2. Enter your Public key.
  3. Enter your Private key.
  4. Optionally, enter a Start date in YYYY-MM-DDTHH:MM:SSZ format (for example, 2017-01-25T00:00:00Z). Only data created or updated after this date is replicated. If you don't set a start date, all available data is replicated.
  5. Click Set up source and wait for the tests to complete.
<HideInUI>

Supported sync modes

The PartnerStack source connector supports the following sync modes:

  • Full Refresh
  • Incremental - Append

Supported streams

The PartnerStack source connector supports the following streams. All streams read from the PartnerStack Vendor API v2.

StreamSync modeCursor field
CustomersIncrementalupdated_at
DealsIncrementalupdated_at
GroupsIncrementalupdated_at
LeadsIncrementalupdated_at
PartnershipsIncrementalupdated_at
RewardsFull Refresh-
TransactionsFull Refresh-

Performance considerations

The PartnerStack API enforces a rate limit of 4,000 requests per minute per IP address. The connector should not run into this limit under normal usage. If you receive HTTP 429 responses, reduce the sync frequency.

Limitations

  • The connector uses the PartnerStack Vendor API, which authenticates with Basic Auth (public key and private key). It does not use the Partner API, which requires Bearer token authentication.
  • The Rewards and Transactions streams do not support incremental sync by updated_at. They filter by min_created using the configured start date, so they perform a full refresh of all records created after the start date on each sync.
</HideInUI>

Changelog

<details> <summary>Expand to review</summary>
VersionDatePull RequestSubject
0.3.122026-03-1074086Add missing fields (test, metadata) to Transactions stream schema
0.3.112025-05-2460453Update dependencies
0.3.102025-05-1060087Update dependencies
0.3.92025-05-0359453Update dependencies
0.3.82025-04-2759089Update dependencies
0.3.72025-04-1958489Update dependencies
0.3.62025-04-1257922Update dependencies
0.3.52025-04-0557330Update dependencies
0.3.42025-03-2956787Update dependencies
0.3.32025-03-2256171Update dependencies
0.3.22025-03-0855537Update dependencies
0.3.12025-03-0153962Update dependencies
0.3.02025-02-2647280Migrate to Manifest-only
0.2.82025-02-0152541Update dependencies
0.2.72025-01-1851913Update dependencies
0.2.62025-01-1151344Update dependencies
0.2.52025-01-0450934Update dependencies
0.2.42024-12-2850723Update dependencies
0.2.32024-12-2150246Update dependencies
0.2.22024-12-1449675Update dependencies
0.2.12024-12-1149085Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.2.02024-12-0348782Add Incremental feature
0.1.252024-11-0448184Update dependencies
0.1.242024-10-2947762Update dependencies
0.1.232024-10-2847045Update dependencies
0.1.222024-10-1246808Update dependencies
0.1.212024-10-0546452Update dependencies
0.1.202024-09-2846111Update dependencies
0.1.192024-09-2145775Update dependencies
0.1.182024-09-1445506Update dependencies
0.1.172024-09-0745294Update dependencies
0.1.162024-08-3145053Update dependencies
0.1.152024-08-2444712Update dependencies
0.1.142024-08-1744358Update dependencies
0.1.132024-08-1243738Update dependencies
0.1.122024-08-1043692Update dependencies
0.1.112024-08-0342757Update dependencies
0.1.102024-07-2042338Update dependencies
0.1.92024-07-1341757Update dependencies
0.1.82024-07-1041466Update dependencies
0.1.72024-07-0941306Update dependencies
0.1.62024-07-0640881Update dependencies
0.1.52024-06-2540378Update dependencies
0.1.42024-06-2240024Update dependencies
0.1.32024-06-1337595Change last_records to last_record
0.1.22024-06-0438964[autopull] Upgrade base image to v1.2.1
0.1.12024-05-2138484[autopull] base image + poetry + up_to_date
0.1.02022-10-27Add PartnerStack source connector
</details>