Synchronize Data
When should you use syncs?
Syncs enable to continuously sync data between your app and external APIs. Use them to:
- keep a list of records in sync between your app and an external system
- take action when records from an external system are created, updated and/or deleted
Syncs handle:
- Efficient API requests and data transformations.
- Unified data schemas across diverse external APIs.
- Advanced job orchestration through the dashboard & API.
- Automated rate-limit handling and retries.
- Built-in pagination.
- Data integrity, deduplication, and change detection.
- Comprehensive logging and monitoring.
Step 0: API authorization
Start by ensuring the external API you intend to work with is authorized. If not, refer to the Authorize APIs guide for guidance.
Step 1: Activate a pre-built sync
Go to the Syncs & Actions tab and click the Add New
button.

From the Provider
dropdown, select the desired API. In the Template
dropdown, pick the sync that correspond to the object(s) you want to synchronize. Click Add Sync
at the page’s bottom.
Fantastic! Nango will now automatically sync these objects in the background.
Step 2: Fetch the synced data
Fetch the synced data
Transition to the Project Settings tab to obtain the secret key essential for fetching the synced data:

Now, collect the continually updated data:
cURL
Node SDK
curl --request GET \
--url 'https://api.nango.dev/sync/records?model=<MODEL-NAME>' \
--header 'Authorization: Bearer <PROJECT-SECRET-KEY>' \
--header 'Connection-Id: <CONNECTION-ID>' \
--header 'Provider-Config-Key: <INTEGRATION-ID>'
Nango also sends webhooks whenever new/updated/deleted records are detected. That’s it 🎉
Next Steps
Dive deeper with the Customize Syncs & Actions guide. Explore the Field Mapping guide or the Webhooks guide.
Questions, problems, feedback?
We’re here to help! Please reach out on the Slack community, we are very active there.