Skip to content
Mindtickle Developer DocsBeta

Try searching for

↑↓ to navigate↵ to openesc to close
Dark mode

Create an integration

Creates a persistent connection between an external CMS or DAM and a root folder in Mindtickle Content Center.

View as Markdown(opens in a new tab)
Use with AI

Open this page in

ChatGPT(opens in a new tab)Claude(opens in a new tab)Cursor(opens in a new tab)

Prerequisites

  1. Authentication and setup: A valid access token.

Endpoint

Section titled “Endpoint”
POST /services/data/v1.0/content/integration

Base URL: the standard REST host for your region. See Base URLs.

Headers: Authorization: Bearer ACCESS_TOKEN, Content-Type: application/json.

Request

Section titled “Request”
Parameter Type Required Description
source_name string Not specified The system pushing the content: AEM_DAM or API.
root_folder_name string Not specified Name of the root folder created in Content Center.

Request example

Section titled “Request example”
{
  "source_name": "AEM_DAM",
  "root_folder_name": "AEM Content"
}

Response

Section titled “Response”
Field Type Description
root_folder_id string ID of the root folder created in Content Center.
integration_id string ID of the integration.

Response example

Section titled “Response example”
{
  "root_folder_id": "123456",
  "integration_id": "AEM Content-789012"
}

Notes

Section titled “Notes”
  • Usage: Create the integration once. The integration_id and root_folder_id it returns identify the integration and its root folder in subsequent content management jobs. Other endpoints use the parameters listed on their own pages.
  • Request fields: Include both source_name and root_folder_name, as shown in the request examples.
  • Values: source_name accepts one of two values, both of which represent push-based integrations. Use AEM_DAM when the pushing system is the Adobe Experience Manager (AEM) digital asset management (DAM) module. Use API for any other external CMS, DAM, or content system that pushes content through these APIs.
  • Behavior: Both values use the same endpoints and follow the same flow. The difference is only in how the source is labeled for attribution and filtering in the Content Center.
  • Permissions: These integrations must be enabled for your Mindtickle account before use. If the relevant integration is not enabled for your tenant, contact Mindtickle Support.