---
title: "Create an integration"
description: "Creates a persistent connection between an external CMS or DAM and a root folder in Mindtickle Content Center."
contentType: "api-reference"
url: "https://developer.mindtickle.com/docs/content-center/integration/create-an-integration/"
---

## Prerequisites

1. [Authentication and setup](/docs/getting-started/authentication-and-setup/): A valid access token.

## Endpoint

```http
POST /services/data/v1.0/content/integration
```

Base URL: the standard REST host for your region. See [Base URLs](/docs/getting-started/authentication-and-setup/#base-urls).

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

## 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

```json
{
  "source_name": "AEM_DAM",
  "root_folder_name": "AEM Content"
}
```

## 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

```json
{
  "root_folder_id": "123456",
  "integration_id": "AEM Content-789012"
}
```

## 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](mailto:support@mindtickle.com).

## Related

- [Get an upload URL](/docs/content-center/files/get-an-upload-url/): Upload a file before syncing it into the integration.
- [Initiate a content management job](/docs/content-center/jobs/initiate-a-content-management-job/): Use the integration ID and root folder ID returned here.
- [Get executions for an integration](/docs/content-center/integration/get-executions-for-an-integration/): Review the sync history of this integration.
- [Delete a synced root folder](/docs/content-center/integration/delete-a-synced-root-folder/): Remove the synced root folder when the integration is no longer needed.