API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Delete a company

Example Request & Response

$ curl https://api.intercom.io/companies/<id> \
-X DELETE \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
HTTP/1.1 200 OK
{
  "id": "5ba682d23d7cf92bef87bfd4",
  "object": "company",
  "deleted": "true"
}
Example Errors

HTTP/1.1 404 FOUND
{
  "type": "error.list",
  "request_id": "9a3d0816-9707-4598-977e-c009ba630148",
  "errors": [
    {
      "code": "not_found",
      "message": "Company Not Found"
    }
  ]
}

You can delete a single company.

Request Path Parameters

ParameterTypeRequiredDescription
idStringYesThe unique identifier for the company which is given by Intercom

Response

This will return an object with details on the deleted company.

AttributeTypeDescription
idStringThe unique identifier for the company which is given by Intercom
objectStringThe type of object - company
deletedBooleanWhether the company has been deleted - true