provider AI Content POST /ai/external_pages
@utdk/intercom /ai/external_pages
Create an external page (or update an external page by external ID)
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.
Intercom-Version header
enum: 1.0, 1.1, 1.2, 1.3…

Try it

Authentication
Configure credentials for Intercom API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

createexternalpage
POST/ai/external_pages
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.

Input

required

The title of the external page.

required

The body of the external page in HTML.

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.

Whether the external page should be used to answer questions by AI Agent. Will not default when updating an existing external page.

Whether the external page should be used to answer questions by AI Copilot. Will not default when updating an existing external page.

required

Always en

required

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.

required

The identifier for the external page which was given by the source. Must be unique for the source.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import intercom from '@utdk/intercom';

await intercom.createexternalpage({
  "Intercom-Version": "2.14",
  "ai_agent_availability": false,
  "ai_copilot_availability": false,
  "locale": "en"
})