Documentation Index
Fetch the complete documentation index at: https://docs.recotap.com/llms.txt
Use this file to discover all available pages before exploring further.
PATCH /accounts/external-ids
Bulk writes your CRM’s external IDs into existing Recotap accounts, matched by domain. Max 100 mappings per request. Designed for the initial ID backfill. Use List Unmapped Accounts first to identify which accounts need IDs, then call this endpoint to write them all in one pass.
curl -X PATCH "http://eapi.recotap.com/api/v1/crm/accounts/external-ids" \
-H "X-Api-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"mappings": [
{ "domain": "acme.com", "externalId": "crm-001" },
{ "domain": "globex.com", "externalId": "crm-002" }
]
}'
| Field | Type | Required | Description |
|---|
mappings | array | Yes | Min 1, max 100 mapping objects |
| Field | Type | Required | Description |
|---|
domain | string | Yes | Domain used to match the Recotap account e.g. "acme.com" |
externalId | string | Yes | Your CRM’s unique ID to write onto the matched account e.g. "crm-001" |
data
{
"matched": 2,
"updated": 2,
"notFound": []
}
| Field | Type | Description |
|---|
matched | number | Accounts found by domain |
updated | number | Accounts successfully written |
notFound | string[] | Domains that did not match any Recotap account e.g. ["unknown.com"] |
Existing externalId values are overwritten without warning. If the same domain appears more than once in the request, the last mapping takes precedence.
