Checking authentication...

Associations

Manage associations between HubSpot CRM objects

2 tools

Get Associations

Read Idempotent

POST /v1/tools/hubspot/getAssociations

Get records associated with a specific HubSpot record. For example, get all contacts associated with a company, or all deals associated with a contact. from_object_type and to_object_type must be one of: contacts, companies, deals, tickets.

Parameters

NameTypeRequiredDescription
from_object_typestringrequiredSource object type (e.g., "companies")
Values: contacts, companies, deals, tickets
object_idstringrequiredID of the source record
to_object_typestringrequiredTarget object type to find associations for (e.g., "contacts")
Values: contacts, companies, deals, tickets

Request

curl -X POST https://api.syncello.io/v1/tools/hubspot/getAssociations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "from_object_type": "contacts",
  "object_id": "example",
  "to_object_type": "contacts"
}'

Response

{
  "results": [
    {
      "toObjectId": 612300140002,
      "associationTypes": [
        {
          "category": "HUBSPOT_DEFINED",
          "typeId": 279,
          "label": null
        },
        {
          "category": "HUBSPOT_DEFINED",
          "typeId": 1,
          "label": "Primary"
        }
      ]
    }
  ]
}

Try It

Try it

Sign in to execute this tool

Create Association

Write Idempotent

POST /v1/tools/hubspot/createAssociation

Create an association (link) between two HubSpot records. For example, link a contact to a company, or a deal to a contact. Uses the default association type for the object pair. from_object_type and to_object_type must be one of: contacts, companies, deals, tickets.

Parameters

NameTypeRequiredDescription
from_object_typestringrequiredSource object type (e.g., "deals")
Values: contacts, companies, deals, tickets
from_object_idstringrequiredID of the source record
to_object_typestringrequiredTarget object type (e.g., "contacts")
Values: contacts, companies, deals, tickets
to_object_idstringrequiredID of the target record

Request

curl -X POST https://api.syncello.io/v1/tools/hubspot/createAssociation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "from_object_type": "contacts",
  "from_object_id": "example",
  "to_object_type": "contacts",
  "to_object_id": "example"
}'

Response

{
  "associated": true,
  "from": "contacts/512300140001",
  "to": "companies/612300140002"
}

Try It

Try it

Sign in to execute this tool