{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can update a single company using the Intercom provisioned `id`.\n\nEvery custom attribute you send must already exist in your workspace. Sending one that doesn't returns a `400` error.\n\nYou can also send this request with `PATCH`; it behaves the same as `PUT`.\n\n{% admonition type=\"warning\" name=\"Using `company_id`\" %}\n  When updating a company it is not possible to update `company_id`. This can only be set once upon creation of the company.\n{% /admonition %}\n\nRequires the `write_users_companies` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"company_id":{"type":"string","examples":["5f4d3c1c-7b1b-4d7d-a97e-6095715c6632"],"description":"The unique identifier for the company which is given by Intercom"}},"required":["company_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/update_company_request","examples":[{"name":"my company","website":"http://www.mycompany.com/"}]}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["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","2.15","2.16","2.17"],"examples":["2.17"]},"update_company_request":{"type":["object","null"],"title":"Update Company Request Payload","description":"You can update a Company","properties":{"name":{"type":"string","description":"The name of the Company. Leading and trailing whitespace is removed.","examples":["Intercom"]},"update_last_request_at":{"type":"boolean","description":"Set to true to update the company's last seen time to now.","examples":[true]},"plan":{"type":"string","description":"The name of the plan you have associated with the company.","examples":["Enterprise"]},"size":{"type":"integer","description":"The number of employees in this company.","examples":[100]},"website":{"type":"string","description":"The URL for this company's website. Please note that the value specified here is not validated. Accepts any string.","examples":["https://www.example.com"]},"industry":{"type":"string","description":"The industry that this company operates in.","examples":["Manufacturing"]},"custom_attributes":{"type":"object","description":"Values for custom attributes that already exist in your workspace. Each value can be a string, integer, number, boolean or null. Arrays and objects aren't accepted.","additionalProperties":{"anyOf":[{"type":["string","null"]},{"type":"integer"},{"type":"number"},{"type":"boolean"}]},"examples":[{"paid_subscriber":true,"monthly_spend":155.5,"team_mates":9}]},"remote_created_at":{"type":"integer","description":"The time the company was created by you.","examples":[1394531169]},"monthly_spend":{"type":"integer","description":"How much revenue the company generates for your business. Floats are truncated to whole integers, so 155.98 is stored as 155. A value above 2147483647 (2**31-1) is stored as 0. 2147483647 itself, or a value of -2147483648 or below, returns a `422` error.","examples":[1000]}}}}},"name":"Update a company","id":"intercom.updatecompany","example":{"path":{"company_id":"5f4d3c1c-7b1b-4d7d-a97e-6095715c6632"}},"maxRequests":1,"summary":false}}