HTTP integrations

Updated 1 month ago by Romain Lapeyre

HTTP integrations allow you to connect any third-party app to Gorgias, that has an API. Think of your company custom back-office, or an app that is not listed on our integration page. 

There are two main uses for HTTP integrations: 

  • Fetch customer data from a third-party to populate the user profile
  • Trigger an action in a third-party app when a ticket is created or updated

Connecting your own back-office

Most support teams use a custom back-office, or admin, to look up customer profiles and perform actions on them. 

With Gorgias, you can:

  • Automatically fetch customer data when a ticket is created
  • Display it next to tickets
  • Use this data

Step 1: before you start

In order to connect your back-office, you’ll need an endpoint from which Gorgias can fetch customer data given the address of a customer. For example:


Then, it would send some info about this email address to Gorgias:


Step 2: plug your back-office API to Gorgias

Once you have an endpoint such as the one above, follow these steps to fetch data on each ticket:

  1. In Gorgias, create an "HTTP Integration"
  2. Use the "GET" method and your back-office URL. It should look like this:{{}}
    • Optional: use a header to pass the API key. For instance: "Authorization, Basic 5Nmy9Z1loPr0M45TVBVRqoKyccj1jI03aGAZEx2fkO4"
  3. Select a trigger
  4. Click "Save"

When a ticket is created or updated, Gorgias will automatically pull customer information from your back-office and display it in the sidebar to the right of your tickets.

Step 3: display the information in the sidebar

Now that we have this customer data available, let's display it next to your tickets! 

  1. Go to a ticket. Make sure your API can return info about the email address of the ticket customer (otherwise, there's nothing we can display)
  2. Add a tag to the ticket, this will trigger ticket updated , and fetch the customer data from your API
  3. Click on the gear icon, at the top right of the page
  4. Drag & drop the yellow section into the sidebar, and build your own widgets!
Manage widgets

Step 4: using the sidebar data in macros

You can use the content of the widgets in your macros. For this, refer to the back-office variables, in the Macro variables article.


When a new ticket is created, you can connect Slack to post a notification in the Slack channel of your choice.

Gorgias notifications in Slack
  1. In Slack, click on "Apps & integrations"
  2. In the top right, click "Build" to add a custom integration
  3. Click "Incoming WebHooks"
  4. Select the channel where you want to see notifications of new tickets, then click "Add Incoming WebHooks Configuration"
  5. Copy the Webhook URL
  6. In Gorgias, create an "HTTP Integration"
  7. Paste the Webhook URL from Slack into the URL
  8. Paste the code below into the body (to pass the ticket information to Slack)
  9. Select "Ticket Created" as a trigger
  10. Click "Add Integration"
Slack notification in Gorgias

Here’s the Request Body (JSON) that you can paste:

              "text": "New ticket <https://{{ticket.account.domain}}{{}}|*{{ticket.subject}}*> from *{{}}*",
              "attachments": [
                      "text": "{{ticket.first_message.body_text}}",
                      "title": "{{ticket.subject}}",
                      "title_link": "https://{{ticket.account.domain}}{{}}"


We're currently integrating with Magento 2 in beta. 

You can:

  • Display customer profiles next to tickets
  • Display orders
  • Insert Magento variables in macros
  • Perform actions (cancel orders, refund payments, etc.)

To enable the Magento integration, please book a 10 minute setup call with us here. Below is a screenshot of how customer & order info will appear:


When you receive a message, you can display the customer profile and the last orders from WooCommerce in Gorgias. Then, you can also perform actions in WooCommerce from Gorgias itself, such as editing an order.

  1. In the General tab of your WooCommerce admin, click enable the REST API 
  2. In the API tab, ensure that the permissions for the API are set to Read/Write
  3. Send the Consumer Key, the Consumer Secret and the url of your WooCommerce admin to, and we'll finish the setup for you!
Note that "enable the REST API" may be under a different tab based on your version of WooCommerce
Woocommerce keys


When you receive a message, you can display the customer profile and the last orders from Prestashop in Gorgias. You can also perform actions in Prestashop from Gorgias itself (such as editing an order).

  1. In your Prestashop admin, click "advanced settings"
  2. Click "Webservice"
  3. Click "Enable"
  4. In the top right, click the "+" icon
  5. Generate an API key, and set all the permissions to "Read" except for "Order & Customer." Set "Order & Customer" to "Read & Write"
  6. Click "Save"
  7. Send your API key to along with the URL of your store, and we’ll finish the setup for you!


When you receive a message, you can display the customer profile from Veeqo, along with their orders and the inventory status, next to the ticket.  

  1. Login into your Veeqo account
  2. Navigate to Employees page
  3. Click on your user
  4. Click Create API Key, and name it Gorgias
  5. Send your API key to along with the URL of your store, and we’ll finish the setup for you!


When you receive a support request, Gorgias can pull up orders from SendOwl and display them.

  1. In your SendOwl account, get your "API Key" and "API Secret"
  2. Go to this website, and paste {your_api_key}:{your_api_secret} from step one in the ASCII Plain Text. For example: HLYmpHWgo1AW9dk:0HvI00Br3S2gXd7
  3. Under the Base64 section, a new code will appear (it should look like this: IEhMWW1wSFdnbzFBVzlkas6MEh2STAwQnIzUzJnWGQ3w==)
  4. Copy the code that has appeared 
  5. In your Gorgias account, click "Integrations," then click "HTTP integrations"
  6. Click "Add new HTTP integration"
  7. Use the following variables for your HTTP Integration:
  8. Add 2 headers:
    • Header 1
      • Key: Authorization
      • Value: Basic {the_code_from_step3}
    • Header 2
      • Key: Accept
      • Value: application/json
  9. Click "Add integration"
  10. Now, go to a ticket, click on the settings wheel in the top right and drag & drop the "data" element into the sidebar. 

Nice job! If you need any help, book a 10 minute help session with us


This integration is not needed if your ShipStation pushes data to Shopify. The shipment info will display in the Shopify widget. In most cases the data will be pushed to Shopify automatically. 

You can display order information from ShipStation, like the order number, the tracking status, or the shipping method.

  1. In your ShipStation account, click "Settings"
  2. Send the "API key" and the "API secret" to, and we’ll finish the setup for you!


You can display ShippingEasy next to support tickets. It's already included in the data Shopify sends to Gorgias, so you need to edit your Shopify widget to display ShippingEasy data.

  1. Go to a ticket of a customer who has Shopify orders
  2. Click on the Settings wheel at the top right corner of the ticket (next to the search bar).
  3. Drag the ShippingEasy data into the order and save the new widgets.

If you need help here, ping us on the support! 


Display the reviews a customer left on your Shopify store next to support tickets.

This feature is not available on the Yotpo free plan. 
  1. In your Yotpo Admin page, click "Settings" under the profile icon
  2. Click "Store Settings"
  3. Scroll down to "API Credentials," then copy the "APP Key"
  4. In your Gorgias account, click on "Integrations," then click "HTTP Integrations," then click "Add HTTP Integration"
  5. Copy the config below. Ensure that you replace the APP key in the URL, so the final result looks like the screenshot:
Integration name: Get reviews left by the user
          Description: Yotpo
          Trigger: Ticket created & Ticket updated
          URL:{Your Yotpo APP key}/yotpo_global_reviews/reviews.json?user_reference={{}}

Nice job! Now you’ll see reviews next to tickets.


LoyaltyLion is a digital loyalty framework that gives ecommerce stores innovative ways to engage and retain customers.

If you're using LoyaltyLion for your loyalty program, you can connect it to Gorgias to display information next to support tickets. 

Benefits of integrating LoyaltyLion

  • When a customer contacts you, display their profile from LoyaltyLion
  • Award points to customers using macros
  • Insert the referral URL as a variable in a macro 

Setup instructions

  1. In your LoyaltyLion account, click on "Settings"
  2. Send the "token" and the "secret" to, and we’ll finish the setup for you!

Swell Rewards

Swell Rewards is a popular loyalty program for e-commerce. You can display how many points customers have next to tickets, and award points with macros. 

Here's how to connect Swell to Gorgias:

  1. Go to your Swell account
  2. Under the Settings page, copy the merchant_id and the api_key
  3. Go to Gorgias, and head to Integrations -> HTTP integrations  -> Add new HTTP integration
  4. Copy the configuration below, replace {{merchant_id}} and {{api_key}} in the URL with the values from step 2, and click Add integration
Integration name: Get customer points
          Description: Swell
          Trigger: Ticket created & ticket updated

Nice! You've added the integration. Now head to a ticket to configure the Swell widget.

  1. Go to a ticket from a customer who has Swell points
  2. Click the settings wheel at the top right
  3. You will be able to drag & drop the Swell data box to the customer information panel and create a widget

If you have trouble adding the integration, book a 5min setup call here and we'll add the integration with you.


You can display customer's attributes from Mailchimp, along with the list the customer is a member of. 

To connect Mailchimp, follow the steps below: 

  1. Go to your Mailchimp account, click on your profile, then on Account and Profile . Detailed instructions here
  2. Copy the API key
  3. From the API key, get the data-center name. It should be something like "us4"
  4. Go to your Gorgias account, to Integrations -> HTTP Integrations
  5. Create an HTTP Integration
  6. Click on Add header
  7. Copy the configuration below and save
Integration name: Pull Mailchimp data
          URL: https://{data center name from step 3}{{}}
          HTTP Method: GET
          Headers: Authorization, apikey {your api key from step 2}

You're all set. Now, head to a new tickets, add a tag to it to trigger the Mailchimp integration, click the settings wheel to build your Mailchimp widget. If you need further help with setup, book a 5min call here.


When you receive a message, you can display customer information from the associated contact in Salesforce.

  1. In Salesforce, click "Setup" in the top right corner of your screen
  2. In Quickfind, type "Apps"
  3. Under "Build," mouse over "Create," and open "Apps"
  4. In the Connected Apps section, click "New"
  5. Enter "Gorgias" as the "Connected App Name" and "App Name," and as the Contact email
  6. Select "Enable OAuth" Settings
  7. Enter as the Callback URL.
  8. Click "Access and manage your data (api)" and click "Add" to add it to the list of Selected OAuth Scopes
  9. Click "Save," then click "Continue"
  10. Click on "Click to reveal" on the Consumer Secret
  11. Send the "Consumer Key" and the "Consumer secret" to
  12. Create an account for, and we’ll finish the setup for you!
Salesforce keys


You can send data about your tickets in Segment by adding Gorgias as a Source on your Segment account. By doing so, you can understand if customers who contacted support in the last year are generating more revenue.

First, add Gorgias as a Source to Segment:

  1. In your Segment account, click on "Sources"
  2. Click "Add Source"
  3. At the end of the list in the server section, click "HTTP API"
  4. Click "Connect"
  5. Type in "Gorgias" as a nickname & SQL schema name, then click "Create source"
  6. Open your newly created Gorgias source
  7. Locate the "Write Key" under installation and copy it
  8. Go to and paste the "Write Key" under "ASCII Plain Text"
  9. After pating the "Write Key" make sure you add a colon character or :  at the end of the string.
  10. Copy the text that shows up in the "Base64" section
Write key in segment

Nice job! Now you can send data to Segment! Next, we need Gorgias to notify Segment when a ticket is created.

  1. In your Gorgias account, click on "Integrations," then click "HTTP Integration," then click "Add HTTP Integration"
  2. Use the following configuration, and click "Add Integration"
Integration name: Send info to segment on Ticket created
          Description: Segment
          Trigger: Ticket created
          HTTP Method: POST
          Headers: Key: Authorization, Value: Basic "paste Base64 code from step 9 here - without the quotes"
          Request Body (JSON):
                  "timestamp": "{{ticket.created_datetime}}",
                  "properties": {
                      "subject": "{{ticket.subject}}",
                      "ticket_id": "{{}}",
                      "status": "{{ticket.status}}",
                      "assignee": "{{ticket.assignee_user}}",
                      "channel": "{{}}",
                      "name": "{{}}",
                      "tags": "{{ticket.tags}}"
                  "userId": "{{}}",
                  "event": "Ticket created"

Nice job! Every time a ticket is created, data about the ticket will be sent to Segment. You can use the sent data in other apps.


Using Zapier, you can trigger a zap when a ticket is created and/or updated.

  1. Create a zap in Zapier and choose a "webhook" as a trigger
  2. In your Gorgias account, click on "Integrations," then click "HTTP Integration," then click "Add HTTP Integration"
  3. Click "POST", then use the webhook URL from Zapier. You can pass arguments from Gorgias to Zapier using headers\
  4. Select a "Trigger" of your choice

Nice job! When the integration is triggered, your zap will run.

How did we do?