> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-mintlify-135bd6b9.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-135bd6b9/2gcI_NiygtPdmJDe/images/customer-guides/marketo-api-role.png?fit=max&auto=format&n=2gcI_NiygtPdmJDe&q=85&s=015ef5c642571355388854a73e57f3c3" 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-135bd6b9/2gcI_NiygtPdmJDe/images/customer-guides/marketo-user.png?fit=max&auto=format&n=2gcI_NiygtPdmJDe&q=85&s=1652803262ab0b55c4ffa115618e372f" 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-135bd6b9/2gcI_NiygtPdmJDe/images/customer-guides/marketo-service.png?fit=max&auto=format&n=2gcI_NiygtPdmJDe&q=85&s=f31ac7219ebff8e835739f50ac7a50b7" 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-135bd6b9/2gcI_NiygtPdmJDe/images/customer-guides/marketo-secrets.png?fit=max&auto=format&n=2gcI_NiygtPdmJDe&q=85&s=6ed7aff0bf759c855692b61cdafb729f" 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-135bd6b9/2gcI_NiygtPdmJDe/images/customer-guides/marketo-accountId.png?fit=max&auto=format&n=2gcI_NiygtPdmJDe&q=85&s=a2bf3355cab18115d3723e530dca5fe3" 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).
