Sign in
Companies
Contacts

Detach a contact from a company

You can detach a company from a single contact.

delete/contacts/{contact_id}/companies/{company_id}

Path parameters

contact_idstring required

The unique identifier for the contact which is given by Intercom

company_idstring required

The unique identifier for the company which is given by Intercom

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

Successful

type'company'

Value is company

idstring

The Intercom defined id representing the company.

namestring

The name of the company.

app_idstring

The Intercom defined code of the workspace the company is associated to.

company_idstring

The company id you have defined for the company.

remote_created_atinteger

The time the company was created by you.

created_atinteger

The time the company was added in Intercom.

updated_atinteger

The last time the company was updated.

last_request_atinteger

The time the company last recorded making a request.

sizeinteger

The number of employees in the company.

websitestring

The URL for the company website.

industrystring

The industry that the company operates in.

monthly_spendinteger

How much revenue the company generates for your business.

session_countinteger

How many sessions the company has recorded.

user_countinteger

The number of users in the company.

custom_attributesobject

The custom attributes you have set on the company.

Example response

{
  "type": "company",
  "id": "531ee472cce572a6ec000006",
  "name": "Blue Sun",
  "app_id": "ecahpwf5",
  "plan": {
    "type": "plan",
    "id": "269315",
    "name": "Pro"
  },
  "company_id": "6",
  "remote_created_at": 1663597223,
  "created_at": 1663597223,
  "updated_at": 1663597223,
  "last_request_at": 1663597223,
  "size": 100,
  "website": "https://www.intercom.com",
  "industry": "Software",
  "monthly_spend": 100,
  "session_count": 100,
  "user_count": 100,
  "custom_attributes": {
    "paid_subscriber": true,
    "monthly_spend": 155.5,
    "team_mates": 9
  },
  "tags": {
    "tags": [
      {
        "type": "tag",
        "id": "123456",
        "name": "Test tag"
      }
    ]
  },
  "segments": {
    "segments": [
      {
        "type": "segment",
        "id": "56203d253cba154d39010062",
        "name": "Active",
        "created_at": 1394621988,
        "updated_at": 1394622004,
        "person_type": "contact",
        "count": 3
      }
    ]
  }
}

Changes

Changed in 1 of the 57 revisions of this API.13

  • 2.14788255ed569413See the full diff
    • ▲

      the tags/tags/items/ response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ○

      added the optional property tags/tags/items/id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tags/tags/items/name to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property tags/tags/items/type to the response with the 200 status

      response-optional-property-added