> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-square-proxy.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-square-proxy/BKP0KITEQK_z6PiA/images/customer-guides/marketo-api-role.png?fit=max&auto=format&n=BKP0KITEQK_z6PiA&q=85&s=21dbb410b946d15e7eedbb0940c3de12" 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-square-proxy/BKP0KITEQK_z6PiA/images/customer-guides/marketo-user.png?fit=max&auto=format&n=BKP0KITEQK_z6PiA&q=85&s=1b0bbd0f690a83abd4a59df36f30163e" 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-square-proxy/BKP0KITEQK_z6PiA/images/customer-guides/marketo-service.png?fit=max&auto=format&n=BKP0KITEQK_z6PiA&q=85&s=c4c4164448ec8688a1c70b38f0ae2667" 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-square-proxy/BKP0KITEQK_z6PiA/images/customer-guides/marketo-secrets.png?fit=max&auto=format&n=BKP0KITEQK_z6PiA&q=85&s=c33d49dcfdcde4c98c8b9e17ea63b186" 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-square-proxy/BKP0KITEQK_z6PiA/images/customer-guides/marketo-accountId.png?fit=max&auto=format&n=BKP0KITEQK_z6PiA&q=85&s=2ce312231c674761776f9137887aaa26" 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).
