# Gorgias

Manage Gorgias e-commerce support: tickets, customers, messages, macros, tags. Exposes **33 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `gorgias_list_tickets` | List tickets - GET /tickets. |
| `gorgias_get_ticket` | Get one ticket - GET /tickets/{id}. |
| `gorgias_create_ticket` | Create a ticket - POST /tickets. |
| `gorgias_update_ticket` | Update a ticket - PATCH /tickets/{id}. |
| `gorgias_bulk_update_tickets` | Bulk update tickets - PATCH /tickets. |
| `gorgias_delete_ticket` | Delete a ticket - DELETE /tickets/{id}. |
| `gorgias_list_messages` | List messages in a ticket - GET /tickets/{id}/messages. |
| `gorgias_get_message` | Get one message - GET /tickets/{ticket_id}/messages/{id}. |
| `gorgias_create_message` | Add a message to a ticket - POST /tickets/{id}/messages. |
| `gorgias_list_customers` | List customers - GET /customers. |
| `gorgias_get_customer` | Get one customer - GET /customers/{id}. |
| `gorgias_create_customer` | Create a customer - POST /customers. |
| `gorgias_update_customer` | Update a customer - PATCH /customers/{id}. |
| `gorgias_list_tags` | List tags - GET /tags. |
| `gorgias_create_tag` | Create a tag - POST /tags. |
| `gorgias_update_tag` | Update a tag - PATCH /tags/{id}. |
| `gorgias_delete_tag` | Delete a tag - DELETE /tags/{id}. |
| `gorgias_list_integrations` | List integrations - GET /integrations. |
| `gorgias_get_integration` | Get one integration - GET /integrations/{id}. |
| `gorgias_create_integration` | Create an integration - POST /integrations. |
| `gorgias_update_integration` | Update an integration - PATCH /integrations/{id}. |
| `gorgias_delete_integration` | Delete an integration - DELETE /integrations/{id}. |
| `gorgias_list_macros` | List macros - GET /macros. |
| `gorgias_get_macro` | Get one macro - GET /macros/{id}. |
| `gorgias_create_macro` | Create a macro - POST /macros. |
| `gorgias_update_macro` | Update a macro - PATCH /macros/{id}. |
| `gorgias_delete_macro` | Delete a macro - DELETE /macros/{id}. |
| `gorgias_list_satisfaction_surveys` | List satisfaction surveys - GET /satisfaction-surveys. |
| `gorgias_get_satisfaction_survey` | Get one satisfaction survey - GET /satisfaction-surveys/{id}. |
| `gorgias_list_teams` | List teams - GET /teams. |
| `gorgias_get_team` | Get one team - GET /teams/{id}. |
| `gorgias_list_users` | List users (agents) - GET /users. |
| `gorgias_get_user` | Get one user (agent) - GET /users/{id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`GORGIAS_DOMAIN`** - Your Gorgias subdomain, e.g. mycompany (from mycompany.gorgias.com).
- **`GORGIAS_EMAIL`** - Email of the Gorgias user that owns the API key.
- **`GORGIAS_API_KEY`** - Gorgias - Settings - REST API - copy your API key. (https://docs.gorgias.com/en-US/finding-your-api-credentials-200520)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `GORGIAS_DOMAIN` | Your Gorgias subdomain, e.g. mycompany (from mycompany.gorgias.com). |
| `GORGIAS_EMAIL` | Email of the Gorgias user that owns the API key. |
| `GORGIAS_API_KEY` | Gorgias - Settings - REST API - copy your API key. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Gorgias API documentation](https://developers.gorgias.com/reference)