Skip to content
Home/
REST API Reference
/
/
Create External Page Payl...

Create External Page Payload

You can add an External Page to your Fin Content Library.

titlestringrequired

The title of the external page.

Example:"Getting started with..."
htmlstringrequired

The body of the external page in HTML.

Example:"<p>Hello world!</p>"
urlstring

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.

Example:"https://help.example.com/en/articles/1234-getting-started"
ai_agent_availabilityboolean

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

Default:false
Example:true
ai_copilot_availabilityboolean

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

Default:false
Example:true
ai_sales_agent_availabilityboolean

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
Example:true
localestringrequired

Always en

Default:"en"
Value:"en"
Example:"en"
source_idintegerrequired

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.

Example:1234
external_idstringrequired

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

Example:"5678"
audience_idsArray of integers or null

The list of audience IDs to target this external page to for Fin AI Agent. Omitting the field preserves any default audience segments inherited from the parent content import source. Pass an explicit array to override inherited defaults with the given set. Pass [] to clear all audience memberships (even if the source has defaults). Unknown audience IDs return a 404 error with no partial commit.

Example:
[
  1,
  2
]
{
  "title": "Getting started with...",
  "html": "<p>Hello world!</p>",
  "url": "https://help.example.com/en/articles/1234-getting-started",
  "ai_agent_availability": true,
  "ai_copilot_availability": true,
  "ai_sales_agent_availability": true,
  "locale": "en",
  "source_id": 1234,
  "external_id": "5678",
  "audience_ids": [
    1,
    2
  ]
}