{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can create or update a company.\n\nCompanies will be only visible in Intercom when there is at least one associated user.\n\nCompanies are looked up via `company_id` in a `POST` request, if not found via `company_id`, the new company will be created, if found, that company will be updated.\n\nYou must send either `company_id` or `id`. A request with neither returns a `400` error.\n\nEvery custom attribute you send must already exist in your workspace. Sending one that doesn't returns a `400` error.\n\n{% admonition type=\"warning\" name=\"Using `company_id`\" %}\n  You can set a unique `company_id` value when creating a company. However, it is not possible to update `company_id`. Be sure to set a unique value 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},"body":{"$ref":"#/definitions/create_or_update_company_request","examples":[{"company_id":"company_remote_id","name":"my company","remote_created_at":1374138000}]}},"required":[],"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"]},"create_or_update_company_request":{"type":["object","null"],"title":"Create Or Update Company Request Payload","description":"You can create or update a Company. Send either `company_id` or `id`; a request with neither returns a `400` error.","properties":{"name":{"type":"string","description":"The name of the Company. Leading and trailing whitespace is removed.","examples":["Intercom"]},"company_id":{"type":"string","description":"The company id you have defined for the company. Can't be updated","examples":["625e90fc55ab113b6d92175f"]},"id":{"type":"string","description":"An alternative name for `company_id`. Supply this or `company_id`.","examples":["625e90fc55ab113b6d92175f"]},"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]},"update_last_request_at":{"type":"boolean","description":"Set to true to update the company's last seen time to now.","examples":[true]},"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":"Create or Update a company","id":"intercom.createorupdatecompany","example":{},"maxRequests":1,"summary":false}}