Advanced Analytica Advanced Analytica: IBOM
← All connectors
Merge logo

Source connector

Merge

Set up Merge as a source and move its data into your chosen destination.

Version 0.2.27 community alpha

Merge

This page explains how to set up the Merge source and provides reference information.

Prerequisites

You need an Access Token, which acts as a bearer token, and linked account tokens. Find them in settings (Bearer ref - https://app.merge.dev/keys) and (Account token ref - https://app.merge.dev/keys).

Setup guide

Step 1: Set up your Merge connection

  • Link your other integrations using account credentials in the accounts section (ref - https://app.merge.dev/linked-accounts/accounts).
  • Get your bearer token from the keys section (ref - https://app.merge.dev/keys).
  • Enter all parameters. Each parameter is required.
  • Available parameters:
    • account_token: Linked account token shown in the linked account section after integration
    • api_token: Bearer token shown in the keys section. Use production keys where possible
    • start_date: Date filter for eligible streams
  • Enable Common Model Scopes for the models you want to sync for the Linked Account (ref - https://help.merge.dev/en/articles/5950052-common-model-and-field-scopes). Streams with a disabled Scope return HTTP 403. They’re skipped with a warning instead of failing the sync.

Step 2: Set up the Merge connector in Airbyte

Airbyte Cloud

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

Airbyte OSS

  1. Go to the Airbyte Open Source dashboard.
  2. Name 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 these 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 currently has v1. The connector uses v1 by default.

IP allow list

If you use Airbyte Cloud and your organisation restricts access by IP, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.2.272026-11-0991390Upgrade base image to source-declarative-manifest:7.47.0
0.2.262026-10-1378834Update dependencies
0.2.252026-10-0788273Fix pagination: send the next cursor as the cursor query parameter (was appended to the URL path, causing 404s on multi-page streams) and request page_size=100; skip (instead of failing on) streams whose Common Model Scope is disabled for the Linked Account (HTTP 403)
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
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.