> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketo

The Marketo integration provides seamless connectivity between allGood and Adobe Marketo Engage, enabling powerful marketing automation and lead management capabilities. This integration synchronizes leads, campaigns, and marketing activities to create a unified customer experience.

Enhance your marketing operations by leveraging Marketo's advanced automation features within allGood's comprehensive workflow platform.

## Prerequisites

Before setting up the Marketo integration with Mary, ensure you have:

* **Administrator access** to the Marketo instance you're creating API access for
* **allGood account** with integration permissions

## IT Coordination Guide

### Security & Account Setup Requirements

* Create a dedicated API-only user in Marketo with appropriate role permissions
* Configure LaunchPoint service for secure API access
* Note IP restrictions — may need to whitelist allGood IP addresses (52.25.122.65, 52.26.241.77)
* Store API credentials securely according to company policy

## Step-by-Step Setup

<Steps>
  <Step title="Create allGood API Role">
    1. **Log into Marketo** with administrator access
    2. Navigate to **Admin** → **Users & Roles** → **Roles**
    3. Click **New Role**

    <Frame caption="Roles page showing New Role button">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/roles_page.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=a384b25670ab8f93afd5d4a5235d4564" alt="Roles page showing New Role button" width="1970" height="846" data-path="images/integrations/marketo/roles_page.png" />
    </Frame>

    4. Give the role a name (e.g., "allGood API Role")
    5. Enable **API Access** checkbox
    6. Click **Create**

    <Frame caption="New Role form with API Access enabled">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/new_role_form.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=7b10a04d8d4de70abb9b919121cf3694" alt="New Role form with API Access enabled" className="mx-auto" style={{ width:"61%" }} width="1201" height="1202" data-path="images/integrations/marketo/new_role_form.png" />
    </Frame>
  </Step>

  <Step title="Create API-Only User">
    1. Navigate to **Admin** → **Users & Roles** → **Users**
    2. Click **Create API Only User**

    <Frame caption="Users page showing Create API Only User button">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/users_page.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=bacfe1bc01598f52c6a1239a67274af3" alt="Users page showing Create API Only User button" width="1946" height="794" data-path="images/integrations/marketo/users_page.png" />
    </Frame>

    3. Enter email address and name for the API user
    4. Assign the role created in Step 1
    5. Click **Create**

    <Frame caption="New API User form with role assignment">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/new_api_user_form.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=838eb2e813825268694dc81de8efd329" alt="New API User form with role assignment" width="1301" height="1001" data-path="images/integrations/marketo/new_api_user_form.png" />
    </Frame>
  </Step>

  <Step title="Create LaunchPoint Service">
    1. Navigate to **Admin** → **LaunchPoint**
    2. Click **New** → **New Service**

    <Frame caption="LaunchPoint page showing New Service option">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/launchpoint_page.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=90c881c39428cc16f3d2e3f94dd27008" alt="LaunchPoint page showing New Service option" width="1582" height="1414" data-path="images/integrations/marketo/launchpoint_page.png" />
    </Frame>

    3. Configure service settings:
       * **Display Name**: allGood Integration
       * **Service Type**: Custom
       * **API Only User**: Select the user created in Step 2
    4. Click **Create**

    <Frame caption="New LaunchPoint form with configuration">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/new_launchpoint_form.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=055bd48e81c1ea3c6e8567280e5bc873" alt="New LaunchPoint form with configuration" width="1100" height="1081" data-path="images/integrations/marketo/new_launchpoint_form.png" />
    </Frame>
  </Step>

  <Step title="Get API Credentials">
    1. Click **View Details** on the service you just created

    <Frame caption="LaunchPoint service list showing View Details link">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/view_launchpoint_details.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=380b70db764a93788b71d827774f4484" alt="LaunchPoint service list showing View Details link" width="1498" height="433" data-path="images/integrations/marketo/view_launchpoint_details.png" />
    </Frame>

    2. Copy the **Client ID** and **Client Secret**
    3. Store these credentials securely

    <Frame caption="Client ID and Secret display screen">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/client_id_and_secret.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=e6b9802dae09f254fc2ee669b5b95ac2" alt="Client ID and Secret display screen" width="1201" height="741" data-path="images/integrations/marketo/client_id_and_secret.png" />
    </Frame>
  </Step>

  <Step title="Get Endpoint URLs">
    1. Navigate to **Admin** → **Web Services**
    2. Copy the **Endpoint** and **Identity** URLs from the REST API section

    <Frame caption="Web Services page showing REST API endpoints">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/rest_api_endpoints.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=fdd724c51882db4cf9b7563f2aefe74a" alt="Web Services page showing REST API endpoints" width="1247" height="1580" data-path="images/integrations/marketo/rest_api_endpoints.png" />
    </Frame>

    3. **Important**: If IP Restrictions are enabled, add these IP addresses:
       * 52.25.122.65
       * 52.26.241.77

    <Frame caption="IP Restrictions section with allGood IPs added">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/ip_restrictions.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=91236a73b0c77e79c29c7c00f11d67eb" alt="IP Restrictions section with allGood IPs added" width="630" height="421" data-path="images/integrations/marketo/ip_restrictions.png" />
    </Frame>
  </Step>

  <Step title="Connect Integration in allGood">
    1. **Log into allGood** and navigate to **Settings** → **Integrations**
    2. Click **Add Integration** and select **Marketo**

    <Frame caption="allGood integrations page">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/add_integration.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=68dd8a78f1806fe3c6eb1c6878f34006" alt="allGood integrations page" width="3083" height="689" data-path="images/integrations/marketo/add_integration.png" />
    </Frame>

    3. Enter the four required credentials:
       * Client ID
       * Client Secret
       * Endpoint URL
       * Identity URL

    <Frame caption="Marketo integration form with credential fields">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/new_integration_form.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=375b6e01b1ab24ea531d645a76fa3c94" alt="Marketo integration form with credential fields" width="1678" height="1390" data-path="images/integrations/marketo/new_integration_form.png" />
    </Frame>

    4. Click **Save** to complete the connection
    5. Verify the integration shows as **Active** on your integrations page

    <Frame caption="allGood integrations page with Marketo marked as Active">
      <img src="https://mintcdn.com/allgoodtechnologyinc/Ch_ZZInnFMnauFYj/images/integrations/marketo/integration_created.png?fit=max&auto=format&n=Ch_ZZInnFMnauFYj&q=85&s=2e912e4b4a59680390b360c33f4b026e" alt="allGood integrations page with Marketo marked as Active" width="2238" height="646" data-path="images/integrations/marketo/integration_created.png" />
    </Frame>
  </Step>
</Steps>

## Verification & Testing

If Marketo shows "Active" status in allGood integrations, Mary was able to connect successfully.

Ask Mary to retrieve basic program or lead information to confirm the integration is working properly.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do I need admin access to Marketo?">
    Yes, you need administrator access to create API users, configure LaunchPoint services, and set up the necessary permissions.
  </Accordion>

  <Accordion title="How do I create API credentials?">
    You'll need to create a dedicated API user, set up a LaunchPoint service, and configure the appropriate role permissions in Marketo. See the step-by-step setup above.
  </Accordion>

  <Accordion title="What are the IP restrictions?">
    Some Marketo instances have IP restrictions. You may need to whitelist allGood's IP addresses (52.25.122.65 and 52.26.241.77) for the integration to work.
  </Accordion>

  <Accordion title="What Marketo objects are supported?">
    The integration supports leads, companies, programs, campaigns, and custom objects from your Marketo instance.
  </Accordion>

  <Accordion title="How does lead scoring sync?">
    Lead scores and other custom fields sync bidirectionally, maintaining consistency across both platforms.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Why am I getting API errors?">
    Common causes include:

    * Incorrect API credentials
    * Exceeded API rate limits
    * IP address restrictions not configured
    * Insufficient user permissions
  </Accordion>

  <Accordion title="How do I monitor sync performance?">
    Use the integration dashboard to monitor sync status, view error logs, and track API usage metrics.
  </Accordion>

  <Accordion title="Where can I get help?">
    * Review this page for setup steps and common issues
    * Contact our support team for technical assistance
  </Accordion>
</AccordionGroup>
