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

# GetResponse Integration

> Connect GetResponse with ChatbotX to add contacts to a List, apply Tags, and set their Autoresponder cycle day from a Flow.

The **GetResponse** integration sends contacts from ChatbotX to a GetResponse List when they reach the action in a Flow. You can select the email field, apply Tags, and place customers on a specific day of an Autoresponder cycle.

For example, after a customer provides an email address to receive an offer, ChatbotX adds the customer to the `Contacts` List, applies the `NEW` Tag, and starts the welcome email series on day 0.

## Prepare your API Key

You need to generate an **API Key** in GetResponse before connecting. This key allows ChatbotX to send contact data to your account.

<Steps>
  <Step title="Sign in to GetResponse">
    Sign in to the GetResponse account that you want to connect to ChatbotX.
  </Step>

  <Step title="Open Integrations and API">
    Select **Tools**, then select **Integrations and API** and open the **API** tab.
  </Step>

  <Step title="Generate an API Key">
    Click **Generate API key**, enter a name that identifies the key, such as `ChatbotX Integration`, then generate it.
  </Step>

  <Step title="Copy the API Key">
    Copy the key and store it securely. GetResponse does not display the key again after you close the window.

    See [Where to find the API key?](https://www.getresponse.com/help/where-do-i-find-the-api-key.html) in the official GetResponse documentation.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/getresponse_api_key_settings.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=191b358cc562d297ab473213974e2e36" alt="GetResponse API Key Settings" width="2709" height="1425" data-path="images/getresponse_api_key_settings.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Do not share your API Key in messages, public screenshots, or customer-facing documents. GetResponse may expire API keys that remain unused for 90 days; generate a new key and reconnect when this happens.
</Warning>

## Connect GetResponse to ChatbotX

<Steps>
  <Step title="Open Settings">
    In your ChatbotX workspace, select **Settings** from the left menu.
  </Step>

  <Step title="Select Integrations">
    Select the **Integrations** tab, then open **GetResponse**.
  </Step>

  <Step title="Open the connection window">
    Click **Connect** to open the **Connect GetResponse** window.
  </Step>

  <Step title="Enter the API Key">
    Paste the key into **API Key**, then click **Confirm**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/connect_getresponse_in_chatbotx_integrations.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=abf1c79f8345608c5b4d65052d717886" alt="Connect GetResponse in ChatbotX Integrations" width="3180" height="1559" data-path="images/connect_getresponse_in_chatbotx_integrations.png" />
    </Frame>
  </Step>
</Steps>

When the key is valid, ChatbotX saves the connection and loads the Lists and Tags from your GetResponse account for use in Flows.

## Add GetResponse to a Flow

After connecting, add the GetResponse action where you want to synchronize the contact. Place the action after collecting the customer's email address so it always has data to send.

<Steps>
  <Step title="Open the Flow">
    Select **Flows**, then open the Flow that you want to use for collecting contacts.
  </Step>

  <Step title="Add Actions">
    In a Send Message node, click **+ Create**, then select **Actions**.
  </Step>

  <Step title="Select Email Actions">
    Open **Email Actions** and select **Add Contact to GetResponse**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/select_add_contact_to_getresponse_action.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=43a5ebbfe76245e56c313296d9a87ba6" alt="Select Add Contact to GetResponse Action" width="3187" height="1884" data-path="images/select_add_contact_to_getresponse_action.png" />
    </Frame>
  </Step>

  <Step title="Open the configuration">
    Click **Edit** on the new action to select a List and map the contact data.
  </Step>
</Steps>

## Configure Add Contact to GetResponse

Configure the fields in the **Add Contact to GetResponse** window, then click **Save**.

| Field                          | Configuration                                                                                                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **List**                       | Select the GetResponse List that will receive the contact, such as `Contacts`.                                                                        |
| **Email Field**                | Select the ChatbotX field that stores the customer's email address. GetResponse uses this value to create the contact.                                |
| **Tags**                       | Select one or more GetResponse Tags to apply, such as `NEW`. This field is optional.                                                                  |
| **Day of Autoresponder Cycle** | Enter the customer's starting day in the Autoresponder cycle. Use `0` for the subscription day and `1` for the following day. This field is optional. |

<Frame>
  <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/configure_add_contact_to_getresponse.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=e85a6b737c15288d9436267b7f5872a5" alt="Configure Add Contact to GetResponse" width="3184" height="1886" data-path="images/configure_add_contact_to_getresponse.png" />
</Frame>

<Note>
  The selected List must have a corresponding Autoresponder if you want to send automated emails. The day entered in ChatbotX should match the first email's scheduled day in the GetResponse cycle.
</Note>

## Example: collect subscribers for an offer

A fashion store wants to send discount codes and introduce new collections by email.

<Steps>
  <Step title="Collect the email address">
    Use Get User Data to request the customer's email address and save the response to the **Email** field.
  </Step>

  <Step title="Add the customer to GetResponse">
    Run **Add Contact to GetResponse**, then select the `Contacts` List, the **Email** field, and the `NEW` Tag.
  </Step>

  <Step title="Start the Autoresponder">
    Set **Day of Autoresponder Cycle** to `0` so the customer receives the first email according to the cycle schedule from the subscription day.
  </Step>
</Steps>

## Test the integration

Before publishing the Flow, test it with an email address that you can verify.

* Open the selected List in GetResponse and confirm that the contact appears.
* Check the email address, Tags, and Autoresponder cycle day.
* If a List or Tag does not appear in ChatbotX, check the connection and reopen the action.
* If the connection fails, generate a new API Key in **Tools > Integrations and API > API**, then reconnect.

<Warning>
  Deleting or replacing the API Key in GetResponse may stop the current connection from working. Update the key in ChatbotX before running the Flow again.
</Warning>
