Create Ticket

Create a new support ticket with an initial message. Supports API, email, chat, phone, and SMS channels. A ticket always requires at least one message.

Update Ticket

Update an existing support ticket. Can change status, priority, assignee, tags, subject, custom fields, and more. Only provide the fields you want to change.

List Satisfaction Surveys

Retrieve a paginated list of customer satisfaction surveys (CSAT). Surveys capture customer feedback after support interactions.

Create Message

Add a new message to an existing ticket. Can create customer replies, agent responses, or internal notes. Supports HTML and plain text content.

Manage Ticket Tags

Add, remove, or replace tags on a ticket. Use "add" to append tags, "remove" to remove specific tags, or "set" to replace all tags on the ticket.

Create Customer

Create a new customer record in Gorgias with contact channels, name, and metadata.

Get User

Retrieve details of a specific helpdesk agent user. Use user ID 0 to get the currently authenticated user.

Get Account

Retrieve account-level information and settings for the Gorgias helpdesk, including domain, plan, and business configuration.

Delete Macro

Permanently delete a macro template.

Update Tag

Update an existing tag's name or color.

Delete Rule

Permanently delete an automation rule.

List Rules

Retrieve a paginated list of automation rules. Rules trigger actions based on ticket events and conditions.

List Tickets

Retrieve a paginated list of support tickets. Can filter by status, assignee, or customer. Use cursor-based pagination to iterate through results.

Search

Search across tickets, customers, and other resources using a unified search interface. Returns matching results with pagination support.

Create Macro

Create a new macro template with a name and a set of actions that will be executed when the macro is applied.

Update Customer

Update an existing customer's profile, contact channels, or metadata. Only provide the fields you want to change.

Delete Tag

Permanently delete a tag. Tickets currently using this tag will have it removed.

Create Tag

Create a new tag for categorizing tickets. Optionally specify a color for visual identification.

List Tags

Retrieve all tags available in the helpdesk. Tags are used to categorize and organize tickets.

List Macros

Retrieve a paginated list of macro templates. Macros are reusable response templates with configurable actions.

Create Rule

Create a new automation rule with events, conditions, and actions. Rules automate ticket handling based on configurable triggers.

Get Customer

Retrieve full details of a customer, including their contact channels, metadata, and associated data.

Update Rule

Update an existing automation rule. Can change name, conditions, actions, priority, or enable/disable the rule.

List Users

Retrieve a paginated list of helpdesk agent users. Includes agent names, emails, roles, and team assignments.

List Messages

Retrieve all messages for a given ticket, ordered by sending date. Includes customer replies, agent responses, and internal notes.

Delete Ticket

Permanently delete a support ticket and all its messages. This action cannot be undone.

List Customers

Retrieve a paginated list of customers. Can filter by email address.

Get Ticket

Retrieve full details of a single support ticket, including messages, customer info, tags, assignee, and satisfaction survey data.

Update Macro

Update an existing macro's name or actions.

Merge Customers

Merge multiple customer records into one. The main customer retains its data, and secondary customers' data is merged into it. Secondary customer records are deleted after merging.