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

# Act-On

> Connect your Act-On account so Mary can act on email replies — unsubscribes, contact syncs, and marketing list adds.

The Act-On integration connects your Act-On instance to allGood for [Email Reply Management](/use-cases/erm/overview), so Mary can unsubscribe senders, sync contacts, and add them to marketing lists the moment she classifies a reply.

Unlike allGood's API-key integrations, Act-On connects over OAuth: you log in with an Act-On user and approve access. There's no API key to create and no credentials to enter.

## Before you begin

You'll need an **Act-On user login** to authorize the connection — a dedicated or shared user on **your own domain** works fine, your choice. That user needs permission to:

* Read contact lists
* Update list records
* Manage marketing-email opt-outs

<Note>
  You don't need to create an API key or enter any credentials — you just log in and approve. allGood only ever receives access tokens; your password is never shared or stored.
</Note>

## Connect the integration

<Steps>
  <Step id="open-the-integration" title="Open the integration">
    In allGood, go to **Settings** → **Integrations**, then find **Act-On** under **CRM**.

    <Frame caption="Act-On listed under Integrations → CRM">
      <img src="https://mintcdn.com/allgoodtechnologyinc/CGvxy7bGZlOzP6z_/images/integrations/act-on/integrations-list.png?fit=max&auto=format&n=CGvxy7bGZlOzP6z_&q=85&s=bfbe636fb8c313d23988c23b44f36349" alt="Act-On listed under Integrations → CRM" width="3270" height="1246" data-path="images/integrations/act-on/integrations-list.png" />
    </Frame>
  </Step>

  <Step id="configure-and-connect" title="Configure and connect">
    Leave **Base URL** as the default for US-hosted Act-On accounts, or enter `https://api-eu.actonsoftware.com` if your account is EU-hosted.

    Leave **Account ID** blank unless you plan to use the [Fetch Act-On Contact](/use-cases/erm/act-on-actions#fetching-contact-data-optional) step — it's the only place that needs it. You'll find it in Act-On under **Account Details**, as the number in `Your Company (47294)`.

    Click **Connect Act-On account**.

    <Frame caption="Create Act-On integration form with Base URL, Account ID, and Connect Act-On account">
      <img src="https://mintcdn.com/allgoodtechnologyinc/CGvxy7bGZlOzP6z_/images/integrations/act-on/create-integration.png?fit=max&auto=format&n=CGvxy7bGZlOzP6z_&q=85&s=222386ebc343bd5bb4b9f2cb92722d28" alt="Create Act-On integration form with Base URL, Account ID, and Connect Act-On account" width="3268" height="1256" data-path="images/integrations/act-on/create-integration.png" />
    </Frame>
  </Step>

  <Step id="log-in-and-approve" title="Log in and approve">
    A window opens on Act-On's login page. Sign in with your Act-On user and grant access. The window closes and the integration shows as connected.

    <Frame caption="Act-On login window">
      <img src="https://mintcdn.com/allgoodtechnologyinc/CGvxy7bGZlOzP6z_/images/integrations/act-on/login-popup.png?fit=max&auto=format&n=CGvxy7bGZlOzP6z_&q=85&s=8bbd5f8c36b38ec2ec67fd4175653163" alt="Act-On login window" width="3276" height="1816" data-path="images/integrations/act-on/login-popup.png" />
    </Frame>
  </Step>
</Steps>

## Confirm it worked

Open any reply-management category, add an Act-On action, and check:

* The **Marketing List** dropdown fills with your Act-On lists.
* On **Sync Contact to Act-On**, after picking a list, the field picker shows that list's columns.

If both populate, you're connected.

## Then: set up your actions

Once connected, configure what Mary does per reply category — unsubscribes, contact syncs, and marketing list adds. See [Act-On Actions](/use-cases/erm/act-on-actions) for the full field-by-field reference, including tokens and best practices.

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Callback URL mismatch&#x22; on the login page">
    allGood support needs to register your environment's callback with Act-On. [Reach out to us](mailto:support@allgoodhq.com).
  </Accordion>

  <Accordion title="Marketing List dropdown is empty">
    Confirm your account has classic contact lists and that the authorizing user can read them.
  </Accordion>

  <Accordion title="An action fails when a reply comes in">
    The authorizing user is likely missing a permission — list update or opt-out. Reconnect with a user that has both.
  </Accordion>
</AccordionGroup>
