> For the complete documentation index, see [llms.txt](https://help.checkoutchamp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.checkoutchamp.com/crm/plugins/data-sources/gorgias.md).
# Gorgias
This article provides a guide on how to connect your Gorgias account with your CheckoutChamp CRM.
{% hint style="info" %}
Gorgias CheckoutChamp Integration Documentation can be found [here](https://docs.gorgias.com/ecommerce-integrations/checkout-champ)
{% endhint %}
***
### Step 1: Obtain Gorgias API Credentials
#### Navigate to **Settings → REST API** to obtain these credentials.
#### **Be sure to save/copy all fields as they will be required for the CRM setup.**
### Step 2: Setup the CRM Plugin
#### Navigate to **Admin** → **Plugins** → **Data Sources** and click on the green “**+Activate**” button on the Gorgias tile
#### **baseUrl** **-** your Gorgias Base API Url used to make requests to Gorgias’ API.
#### **userName** **-** your Gorgias REST API username as it shows in Gorgias.
#### **apiKey** **-** your Gorgias API key (required)
#### **IntegrationId -** read-only value that represents the Id of the Gorgias integration.
#### Once the plugin is activated you should now see a new HTTP Integration and also a few macros to be used with this integration inside of Gorgias.
### Step 3: Verify that the Integration and Widget were successfully created.
**Integrations can be found in Settings → General → Integrations. You should see an HTTP integration named “CheckoutChamp Integration”.**
**The CheckoutChamp Integration pulls orders from the CRM based on email address used in the ticket.**
**If the customer exists the widget on the right will populate with the customer’s order data. Please see below.**
### Step 4: Verify the Macros were successfully created.
**Macros can be found in Settings → Automation → Macros. Once on the Macro page you should see 11 CheckoutChamp macros.**
**CheckoutChamp Full Refund** - Allows for a Gorgias rep to issue a refund for a particular order.
**CheckoutChamp Partial Refund** - Allows for a Gorgias rep to issue a partial refund for a particular order.
**CheckoutChamp Shipping Address Change** - Allows for a Gorgias rep to change shipping address details tied to an order.
**CheckoutChamp Billing Address Change** - Allows for a Gorgias rep to change billing address details tied to an order.
**CheckoutChamp Cancel Order** - Allows for a Gorgias rep to cancel an order. Can issue full refunds.
**CheckoutChamp Customer Note** - Allows for a Gorgias rep to add a note to a customer record in the CRM.
**CheckoutChamp Customer Update** - Allows for a Gorgias rep to update info on a CRM customer's record.
**CheckoutChamp Cancel Subscription** - Allows for a Gorgias rep to cancel a CRM Subscription.
**CheckoutChamp Pause Subscription** - Allows for a Gorgias rep to pause a CRM Subscription.
**CheckoutChamp Update Subscription Bill Cycle** - Allows for a Gorgias rep to update a CRM Subscription.
**CheckoutChamp Update Subscription Products** - Allows for a Gorgias rep to update a CRM Subscription.
{% hint style="info" %}
A note on Gorgias Operations. If a value in a text box is defaulted to 0, it is a true/false value. Enter 0 for false, 1 for true.
{% endhint %}
{% hint style="warning" %}
Troubleshooting: If the Gorgias Widget, or any macro, is accidentally deleted, delete the Gorgias plugin and repeat these steps to restore them.
{% endhint %}
