Add a contact to a company

Associates a contact with a company. If the company doesn't exist and you provide a custom
company ID (with cid: prefix), it will be automatically created.

How to Identify the Contact

Use any of these identifier formats in the URL path:

• Numeric ID: 12345
• Custom user ID: cuid:user_123
• Custom lead ID: clid:lead_456
• WhatsApp: wa:+1234567890
• Email: uem:[email protected] or lem:[email protected]

How to Identify the Company

In the request body, use company_id with one of these formats:

• Numeric ID: 12345 (company must exist)
• Custom company ID: cid:company_abc123 (will be created if it doesn't exist)

Auto-Create Company Behavior

• If you use a numeric company ID and it doesn't exist, the request will fail with 404
• If you use a custom company ID (cid:...) and it doesn't exist, it will be automatically created
  • The new company will use the company_name from the request (or the custom_company_id if name is not provided)
  • You can optionally set company attributes in the same request

Request Body

• company_id (required): Company identifier (numeric or cid:custom_id)
• company_name (optional): Company name (used when auto-creating a company)
• attributes (optional): Object with custom company attributes to set

Response

Returns HTTP 201 (Created) with an empty response body on success.

Example Requests

# Add contact to existing company
PUT /contacts/cuid:user_123/companies
{
  "company_id": "12345"
}

# Add contact to company (auto-create if doesn't exist)
PUT /contacts/29911301/companies
{
  "company_id": "cid:acme_corp",
  "company_name": "Acme Corporation",
  "attributes": {
    "industry": "Technology",
    "employees": "50-100"
  }
}