[ API REFERENCE ]
Programmatically detect and merge duplicate records in your Attio CRM workspace. Our API enables you to automate duplicate detection, review matches, and execute merges at scale.
# Trigger a duplicate scan
curl -X POST \
https://usededupe.com/api/v1/scans \
-H "Authorization: Bearer attio_pk_..." \
-H "Content-Type: application/json" \
-d '{"workspaceId": "your-workspace-id"}'Generate an API key from your dashboard settings. Choose the scopes you need based on the operations you want to perform.
Go to Settings →Start a duplicate detection scan on your workspace. The scan runs asynchronously and you'll get a run ID to track progress.
POST /api/v1/scansQuery detected duplicates and execute merges programmatically. Set priorities and merge strategies for each pair.
GET /api/v1/duplicatesPOST /api/v1/mergesAll API requests require authentication using an API key. You can provide the key in one of two ways:
Authorization: Bearer attio_pk_your_api_key_hereX-API-Key: attio_pk_your_api_key_hereAPI keys can be created with specific scopes to limit access. Choose only the scopes your integration needs:
| Scope | Access |
|---|---|
scans:trigger | Trigger duplicate scans |
duplicates:read | Query duplicate pairs |
merges:execute | Execute merge operations |
Explore endpoints, view request/response schemas, and try out API calls directly.