{
"associations": [
{
"contactCRMId": "contact_8f3k2j",
"companyCRMId": "account_4k8j2m"
},
{
"contactCRMId": "contact_9x7m4n",
"companyCRMId": "account_4k8j2m"
}
]
}
{
"success": true,
"created": 2
}
Associations
Create associations
Link contacts to companies in your CRM
POST
/
associations
{
"associations": [
{
"contactCRMId": "contact_8f3k2j",
"companyCRMId": "account_4k8j2m"
},
{
"contactCRMId": "contact_9x7m4n",
"companyCRMId": "account_4k8j2m"
}
]
}
{
"success": true,
"created": 2
}
Your Implementation Required
This endpoint must be implemented on your server
Request
array
required
Array of contact-company pairs to link
Association Object
string
required
The CRM ID of the contact (returned from create/sync)
string
required
The CRM ID of the company (returned from create/sync)
{
"associations": [
{
"contactCRMId": "contact_8f3k2j",
"companyCRMId": "account_4k8j2m"
},
{
"contactCRMId": "contact_9x7m4n",
"companyCRMId": "account_4k8j2m"
}
]
}
Response
boolean
required
Whether the operation succeeded
number
Number of associations created
array
Array of failed associations (if any)
{
"success": true,
"created": 2
}
Partial Success
{
"success": true,
"created": 1,
"errors": [
{
"contactCRMId": "contact_invalid",
"companyCRMId": "account_4k8j2m",
"error": "Contact not found"
}
]
}
Use upsert logic to handle duplicate associations gracefully (ignore if already exists).