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

# How to Connect Gorgias

> Connect Gorgias from Settings > Integrations so agents can see a customer's referral status in the ticket sidebar.

Gorgias lives in the **Essentials** section of **Settings > Integrations**. It's a native, self-serve connection - you enter your details once and Mention Me completes the rest of the setup automatically.

## What It Does

Once connected, Mention Me adds a summary of a customer's referral programme status to the ticket sidebar in Gorgias, so support agents can see it without leaving the ticket. The summary includes:

* Whether the customer is enrolled and their programme status
* Whether they were referred, and by whom
* Whether they've referred others, and how many successful referrals they have
* Any pending or issued rewards, including type, value, and expiry
* The date and outcome of their most recent referral

<Warning>
  The lookup matches on email address only. If a customer's Gorgias email is
  different from the email they used on your referral programme, Mention Me
  can't find a match and no referral status appears.
</Warning>

Connecting needs a merchant admin role. Other roles can view the card but can't connect or edit it.

## Connect Gorgias

<Steps>
  <Step title="Generate a Gorgias API key">
    In Gorgias, generate an API key for a user account. See <a href="https://support.gorgias.com/hc/en-us" target="_blank" rel="noopener noreferrer">Gorgias's own documentation</a> for the exact steps, since this menu can vary by plan.

    Note down your **Gorgias domain** (e.g. `yourstore.gorgias.com`), the **user email** the key is tied to, and the **API key** itself.

    <Warning>
      Treat the API key like a password. Anyone with it, your domain, and the associated email can look up referral status for any customer on your account.
    </Warning>
  </Step>

  <Step title="Open the Gorgias card">
    Go to **Settings > Integrations** and find **Gorgias** in the **Essentials** section. Click **Connect**.
  </Step>

  <Step title="Enter your details">
    Enter your Gorgias domain, user email, and API key, then submit. Mention Me validates the details and completes the rest of the setup automatically - there's nothing further to configure in Gorgias yourself.
  </Step>
</Steps>

## Verify It's Working

<Steps>
  <Step title="Open a ticket for a known customer">
    In Gorgias, open a support ticket from a customer whose email you know is
    enrolled in your Mention Me referral programme.
  </Step>

  <Step title="Check the ticket sidebar">
    Confirm the Mention Me referral summary appears in the ticket sidebar,
    showing that customer's programme status.
  </Step>
</Steps>

If nothing appears, check the troubleshooting section below before contacting support.

## Troubleshooting

| Symptom                                            | Likely Cause                                                                                                           |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| No referral status shown                           | The customer's Gorgias email doesn't match their Mention Me email, or they aren't enrolled in the programme            |
| Connection fails to save                           | Double-check the domain, email, and API key - Mention Me validates these against Gorgias before saving                 |
| Integration stops working after previously working | The Gorgias API key has been rotated or revoked - generate a new one in Gorgias and reconnect with the updated details |

## See Also

<CardGroup cols={1}>
  <Card title="Integrations" icon="puzzle-piece" href="/knowledge-app/integrations/overview">
    The full directory of platforms Mention Me connects with.
  </Card>
</CardGroup>