> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.doc-detective.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.doc-detective.com/_mcp/server.

# Heretto CMS integration

> Reference for the `Heretto CMS integration` schema.

## Referenced In

* [Integrations options](/reference/schemas/integrations-options)

## Fields

| Field                | Type    | Description                                                                                                                                                                                                                                                                                                | Default         |
| :------------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |
| name                 | string  | Required. Unique identifier for this Heretto integration. Used in logs and results.                                                                                                                                                                                                                        | —               |
| organizationId       | string  | Required. The organization subdomain used to access Heretto CCMS (e.g., 'thunderbird' for thunderbird.heretto.com).                                                                                                                                                                                        | —               |
| username             | string  | Required. Heretto CCMS username (email address) for API authentication.                                                                                                                                                                                                                                    | —               |
| apiToken             | string  | Required. API token generated in Heretto CCMS for authentication. See [https://help.heretto.com/en/heretto-ccms/api/ccms-api-authentication/basic-authentication#ariaid-title3](https://help.heretto.com/en/heretto-ccms/api/ccms-api-authentication/basic-authentication#ariaid-title3) Minimum length: 1 | —               |
| scenarioName         | string  | Optional. Name of the scenario to build and test.                                                                                                                                                                                                                                                          | `Doc Detective` |
| outputPath           | string  | ReadOnly. Local path where Heretto content was downloaded. Set automatically during processing.                                                                                                                                                                                                            | —               |
| fileMapping          | object  | ReadOnly. Mapping of local file paths to Heretto file metadata. Set automatically during content loading.                                                                                                                                                                                                  | —               |
| uploadOnChange       | boolean | Optional. If `true`, uploads changed screenshots and other media files back to Heretto CMS after test execution.                                                                                                                                                                                           | `false`         |
| resourceDependencies | object  | ReadOnly. Mapping of Heretto file paths to their UUIDs and metadata. Set automatically during content loading by fetching ditamap resource dependencies.                                                                                                                                                   | —               |

## Examples

```json
{
  "name": "example",
  "organizationId": "example",
  "username": "example",
  "apiToken": "example",
  "scenarioName": "Doc Detective",
  "uploadOnChange": false
}
```