{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can create a new external page by sending a POST request to this endpoint. If an external page already exists with the specified source_id and external_id, it will be updated instead.\n\nOAuth tokens must have the `read_write_ai_content` scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/create_external_page_request","examples":[{"audience_ids":[1,2],"external_id":"abc1234","html":"<html><body><h1>Test</h1></body></html>","locale":"en","source_id":44,"title":"Test","url":"https://www.example.com"}]}},"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_external_page_request":{"title":"Create External Page Payload","type":"object","description":"You can add an External Page to your Fin Content Library.","properties":{"title":{"type":"string","description":"The title of the external page.","examples":["Getting started with..."]},"html":{"type":"string","description":"The body of the external page in HTML.","examples":["<p>Hello world!</p>"]},"url":{"type":"string","description":"The URL of the external page. This will be used by Fin to link end users to the page it based its answer on. When a URL is not present, Fin will not reference the source.","examples":["https://help.example.com/en/articles/1234-getting-started"]},"ai_agent_availability":{"type":"boolean","description":"Whether the external page should be used to answer questions by AI Agent. Will not default when updating an existing external page.","default":false,"examples":[true]},"ai_copilot_availability":{"type":"boolean","description":"Whether the external page should be used to answer questions by AI Copilot. Will not default when updating an existing external page.","default":false,"examples":[true]},"ai_sales_agent_availability":{"type":"boolean","description":"Whether the external page should be used to answer questions by AI Sales Agent. Will not default when updating an existing external page.","default":false,"examples":[true]},"locale":{"type":"string","description":"The language code of the external page, for example `en` or `fr`. It must be a language supported by the workspace.","examples":["en"]},"source_id":{"type":"integer","description":"The unique identifier for the source of the external page which was given by Intercom. Every external page must be associated with a Content Import Source which represents the place it comes from and from which it inherits a default audience (configured in the UI). For a new source, make a POST request to the Content Import Source endpoint and an ID for the source will be returned in the response.","examples":[1234]},"external_id":{"type":"string","description":"The identifier for the external page which was given by the source. Must be unique for the source.","examples":["5678"]},"audience_ids":{"type":["array","null"],"description":"The list of audience IDs to target this external page to for Fin AI Agent. Omitting the field keeps the default audience inherited from the source. Pass `[]` to clear all audience memberships, including the inherited ones. If an external page already exists with the specified source_id and external_id, omitting the field leaves its audience memberships unchanged. Unknown audience IDs return a `404` error.","items":{"type":"integer"},"examples":[[1,2]]}},"required":["title","html","locale","source_id","external_id"]}}},"name":"Create an external page (or update an external page by external ID)","id":"intercom.createexternalpage","example":{},"maxRequests":1,"summary":false}}