Fresh 2026

SOP: Set Up Webhooks for Incremental Sync

Procedure to receive real-time change notifications and pull only changed records.

Prerequisites

• A public HTTPS endpoint in your app to receive webhook deliveries.
• A connected Linked Account.

Procedure

1. Create a receiving endpoint. Stand up an HTTPS route that accepts POST and returns 2xx quickly.
2. Register the webhook. In the Merge dashboard, configure the webhook for the change events you care about (for example, synced data changed).
3. Verify deliveries. Validate the signature on each delivery before trusting the payload.
4. Pull changed data. On a change event, call the relevant list endpoint with modified_after=<last_sync_time> to retrieve only records changed since your last pull.
5. Advance your cursor. Store the latest modified_after timestamp after a successful pull.

Verification

• A test change at the source triggers a webhook delivery.
• Your modified_after pull returns only the changed records, not the full dataset.

Related

• Webhooks
• Syncing Best Practices
• Data Sync Flow