Skip to main content

Merge

This page contains the setup guide and reference information for the Merge source

Prerequisites​

Access Token (which acts as bearer token) and linked accounts tokens are mandate for this connector to work, It could be seen at settings (Bearer ref - https://app.merge.dev/keys) and (Account token ref - https://app.merge.dev/keys).

Setup guide​

Step 1: Set up Merge connection​

  • Link your other integrations with account credentials on accounts section (ref - https://app.merge.dev/linked-accounts/accounts)
  • Get your bearer token on keys section (ref - https://app.merge.dev/keys)
  • Setup params (All params are required)
  • Available params
    • account_token: Linked account token seen after integration at linked account section
    • api_token: Bearer token seen at keys section, try to use production keys
    • start_date: Date filter for eligible streams

Step 2: Set up the Merge connector in Airbyte​

For Airbyte Cloud:​

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. On the Set up the source page, enter the name for the merge connector and select Merge from the Source type dropdown.
  4. Enter your account_token, api_token and start_date.
  5. Click Set up source.

For Airbyte OSS:​

  1. Navigate to the Airbyte Open Source dashboard.
  2. Set the name for your source.
  3. Enter your account_token, api_token and start_date.
  4. Click Set up source.

Supported sync modes​

The Merge source connector supports the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncNo
Replicate Incremental DeletesNo
SSL connectionYes
NamespacesNo

Supported Streams​

  • account_details
  • activities
  • applications
  • attachments
  • candidates
  • departments
  • eeocs
  • interviews
  • job-interview-stages
  • jobs
  • offers
  • offices
  • sync_status
  • users

API method example​

GET https://api.merge.dev/api/ats/v1/account-details

Performance considerations​

Merge API reference has v1 at present. The connector as default uses v1.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
account_token
string
api_token
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.2.242025-05-2460605Update dependencies
0.2.232025-05-1059794Update dependencies
0.2.222025-05-0359229Update dependencies
0.2.212025-04-2658819Update dependencies
0.2.202025-04-1958225Update dependencies
0.2.192025-04-1257679Update dependencies
0.2.182025-04-0557085Update dependencies
0.2.172025-03-2956706Update dependencies
0.2.162025-03-2256049Update dependencies
0.2.152025-03-0855468Update dependencies
0.2.142025-03-0154825Update dependencies
0.2.132025-02-2254301Update dependencies
0.2.122025-02-1553802Update dependencies
0.2.112025-02-0853274Update dependencies
0.2.102025-02-0152715Update dependencies
0.2.92025-01-2552234Update dependencies
0.2.82025-01-1851822Update dependencies
0.2.72025-01-1151221Update dependencies
0.2.62024-12-2850627Update dependencies
0.2.52024-12-2150092Update dependencies
0.2.42024-12-1449652Update dependencies
0.2.32024-12-1249222Update dependencies
0.2.22024-12-1147906Starting 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.12024-10-2847593Update dependencies
0.2.02024-08-2644768Refactor connector to manifest-only format
0.1.152024-08-2444665Update dependencies
0.1.142024-08-1744297Update dependencies
0.1.132024-08-1243778Update dependencies
0.1.122024-08-1043661Update dependencies
0.1.112024-08-0343074Update dependencies
0.1.102024-07-2742645Update dependencies
0.1.92024-07-2042313Update dependencies
0.1.82024-07-1341862Update dependencies
0.1.72024-07-1041572Update dependencies
0.1.62024-07-0941246Update dependencies
0.1.52024-07-0640932Update dependencies
0.1.42024-06-2540272Update dependencies
0.1.32024-06-2240163Update dependencies
0.1.22024-06-0639238[autopull] Upgrade base image to v1.2.2
0.1.12024-05-2038445[autopull] base image + poetry + up_to_date
0.1.02023-04-18InitInitial commit