Skip to main content
POST
/
associations
{
  "associations": [
    {
      "contactCRMId": "contact_8f3k2j",
      "companyCRMId": "account_4k8j2m"
    },
    {
      "contactCRMId": "contact_9x7m4n",
      "companyCRMId": "account_4k8j2m"
    }
  ]
}

{
  "success": true,
  "created": 2
}

Documentation Index

Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your Implementation Required

This endpoint must be implemented on your server
Enginy calls this endpoint to create relationships between contacts and companies after both have been created or synced.

​
Request

​
associations
array
required
Array of contact-company pairs to link

​
Association Object

​
contactCRMId
string
required
The CRM ID of the contact (returned from create/sync)
​
companyCRMId
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

​
success
boolean
required
Whether the operation succeeded
​
created
number
Number of associations created
​
errors
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).