# Companies

Everything about your Companies

 - [POST /companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/createorupdatecompany.md): You can create or update a company. Companies will be only visible in Intercom when there is at least one associated user. Companies are looked up via `company_id` in a `POST` request, if not found vi
 - [GET /companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/retrievecompany.md): You can fetch a single company by passing in `company_id` or `name`. `https://api.intercom.io/companies?name={name}` `https://api.intercom.io/companies?company_id={company_id}` You can fetch all compa
 - [GET /companies/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/retrieveacompanybyid.md): You can fetch a single company.
 - [PUT /companies/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/updatecompany.md): You can update a single company using the Intercom provisioned `id`. When updating a company it is not possible to update `company_id`. This can only be set once upon creation of the company.
 - [DELETE /companies/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/deletecompany.md): Delete a single company. The company record is kept in your workspace, but all contacts are detached. The contacts themselves are not deleted. Detaching contacts is permanent and can't be reversed. A
 - [GET /companies/{id}/contacts](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listattachedcontacts.md): You can fetch a list of all contacts that belong to a company.
 - [GET /companies/{id}/segments](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listattachedsegmentsforcompanies.md): You can fetch a list of all segments that belong to a company.
 - [GET /companies/{company_id}/notes](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listcompanynotes.md): You can fetch a list of notes that are associated to a company.
 - [POST /companies/{company_id}/notes](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/createcompanynote.md): You can add a note to a single company.
 - [POST /companies/search](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/searchcompanies.md): You can search for companies by the value of their attributes in order to fetch exactly the companies you want. To search for companies, send a `POST` request to `https://api.intercom.io/companies/sea
 - [POST /companies/list](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listallcompanies.md): You can list companies. The company list is sorted by the `last_request_at` field and by default is ordered descending, most recently requested first. Note that the API does not include companies who
 - [GET /companies/scroll](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/scrolloverallcompanies.md): The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. The Scroll API provides an efficient mechanism for it
 - [POST /contacts/{id}/companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/attachcontacttoacompany.md): You can attach a company to a single contact.
 - [GET /contacts/{id}/companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listcompaniesforacontact.md): You can fetch a list of companies that are associated to a contact.
 - [DELETE /contacts/{contact_id}/companies/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/detachcontactfromacompany.md): You can detach a company from a single contact.
 - [POST /companies/bulk](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/bulkcreatecompanies.md): You can bulk create or update companies by submitting an array of company objects. Each company is matched on the `company_id` you have defined for it: a new company is created if none exists with tha
 - [PUT /companies/bulk](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/bulkupdatecompanies.md): You can bulk update companies by submitting an array of company objects with the fields to update. Each company must include an `id` field identifying the company to update by its Intercom company `id
 - [POST /companies/bulk/delete](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/bulkdeletecompanies.md): You can bulk delete companies by submitting an array of companies, each identified by its Intercom company `id`. Deleting a company detaches all of its associated contacts but keeps the company record
 - [GET /companies/bulk/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/showbulkcompaniesjob.md): You can check the status of a bulk companies job. The `state` field indicates the overall job progress: `pending`, `running`, `completed`, or `completed_with_errors`.
 - [GET /contacts/{contact_id}/granted_companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/listgrantedcompaniesforacontact.md): List the companies a contact has been granted access to. A granted company lets the contact read that company's tickets in the customer portal. It is separate from company membership — granting a comp
 - [PUT /contacts/{contact_id}/granted_companies](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/replacegrantedcompaniesforacontact.md): Replace the full set of companies a contact has been granted access to. This is a replacement, not an append. The `company_ids` you send become the contact's entire granted set — any company id you le
 - [DELETE /contacts/{contact_id}/granted_companies/{company_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/removegrantedcompanyfromacontact.md): Remove a single company from a contact's granted set, leaving the contact's other grants in place. Identify the company by the `company_id` you set on it, the same value [`GET /contacts/{contact_id}/g
 - [Companies Bulk Job](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/companies_bulk_job.md): Schema: #/components/schemas/companies_bulk_job
 - [Company](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/companies/company.md): Schema: #/components/schemas/company