> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-mintlify-b3512787.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketo

## Checklist before installing a Marketo integration

We recommend completing the following steps before installing the Marketo integration to ensure a smooth setup.

### 1. Create an API-Only Role

1. Log in to **Adobe Experience**.
2. Click on **Marketo Engage** and launch your instance.
3. At the top, navigate to **Admin**.
4. In the left sidebar, go to **Admin** → **Security** → **Users & Roles**.
5. Click on **Roles**, then **New Role**, and provide the API role name (used in Step 2).
6. Select the appropriate API access permissions for this role.\\
   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-b3512787/FOtAtSuAj6eVDamY/images/customer-guides/marketo-api-role.png?fit=max&auto=format&n=FOtAtSuAj6eVDamY&q=85&s=c5d9a88cff070eb69b47bc94cd564120" alt="Img" width="2556" height="1206" data-path="images/customer-guides/marketo-api-role.png" />
7. Click **Create**.

For more information, refer to [Marketo's official documentation](https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/administration/users-and-roles/create-an-api-only-user-role).

### 2. Create an API-Only User

1. Log in to **Adobe Experience**.
2. Click on **Marketo Engage** and launch your instance.
3. At the top, navigate to **Admin**.
4. In the left sidebar, go to **Admin** → **Security** → **Users & Roles**.
5. Click on **Users**, then **Create API Only User**, and fill in the required details.
6. Under **Roles**, select the role created in Step 1.\\
   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-b3512787/FOtAtSuAj6eVDamY/images/customer-guides/marketo-user.png?fit=max&auto=format&n=FOtAtSuAj6eVDamY&q=85&s=46acea3c02355cd67959b4bf9765504f" alt="Img" width="2555" height="1132" data-path="images/customer-guides/marketo-user.png" />
7. Click **Create**.

For more information, refer to [Marketo's official documentation](https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/administration/users-and-roles/create-an-api-only-user).

### 3. Create a Custom Service

1. Log in to **Adobe Experience**.
2. Click on **Marketo Engage** and launch your instance.
3. At the top, navigate to **Admin**.
4. In the left sidebar, go to **Admin** → **Integration** → **LaunchPoint**.
5. Click on **New** → **New Service**, and provide the following details:
   * **Display Name**: (Your preference)
   * **Service**: Custom
   * **Description**: (Your preference)
   * **API Only User**: Select the user created in Step 2\\
     <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-b3512787/FOtAtSuAj6eVDamY/images/customer-guides/marketo-service.png?fit=max&auto=format&n=FOtAtSuAj6eVDamY&q=85&s=cf5f683c7512a130cca0ac7edb195e1e" alt="Img" width="2555" height="1112" data-path="images/customer-guides/marketo-service.png" />
6. Click **Create**.
7. After creation, you can view the **Client ID** and **Client Secret** by clicking **View Details**.\\
   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-b3512787/FOtAtSuAj6eVDamY/images/customer-guides/marketo-secrets.png?fit=max&auto=format&n=FOtAtSuAj6eVDamY&q=85&s=91745ce5ba2ab72c7edd42c3a10dfbd3" alt="Img" width="2542" height="1031" data-path="images/customer-guides/marketo-secrets.png" />
8. You will also need the `workspaceId` (Munchkin Account ID). This can be found under **Admin** → **Integration** → **Munchkin**.\\
   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-b3512787/FOtAtSuAj6eVDamY/images/customer-guides/marketo-accountId.png?fit=max&auto=format&n=FOtAtSuAj6eVDamY&q=85&s=5ab0abbf7fd7c1100b38888a4be007f3" alt="Img" width="2555" height="1223" data-path="images/customer-guides/marketo-accountId.png" />

For more information, refer to [Marketo's official documentation](https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/administration/additional-integrations/create-a-custom-service-for-use-with-rest-api#_blank).
