Create associations

{
  "associations": [
    {
      "contactCRMId": "contact_8f3k2j",
      "companyCRMId": "account_4k8j2m"
    },
    {
      "contactCRMId": "contact_9x7m4n",
      "companyCRMId": "account_4k8j2m"
    }
  ]
}

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

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

Enginy calls this endpoint to create relationships between contacts and companies after both have been created or synced.

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).

Overview Overview

Getting Started

Contacts

Companies

Associations

Tasks

Activities

Users (Optional)

Examples

Your Implementation Required

Request

Association Object

Response

Partial Success

Your Implementation Required

​Request

​Association Object

​Response

​Partial Success

Request

Association Object

Response

Partial Success