StyloDocs
Workflow blocks

Gorgias

Look up support tickets and customers in Gorgias — including a customer's recent ticket history

View as Markdown

gorgias/manage — Look up support tickets and customers in Gorgias — including a customer's recent ticket history.

Where it appears

The Gorgias block lives in the Integrations group of the Workflow Builder. Connect the Gorgias integration before adding it.

Fields

FieldTypeRequiredDefaultDescription
resourceselectYesticketWhich Gorgias resource to work with. Options: ticket, customer.
operationselectYesWhich action to perform on the selected resource.
ticketIdtext (supports references)NoThe ticket to fetch (or whose messages to list).
filterCustomerIdtext (supports references)NoOptionally restrict the list to a single customer's tickets.
customerIdtext (supports references)NoThe customer to fetch.
customerLookuptext (supports references)NoThe customer to look up. An email (contains @) is resolved to the customer automatically; otherwise it's treated as a customer ID. Returns the customer plus their recent tickets.
customerQuerytextNoEmail (exact match) or a name. An email (contains @) uses the exact email filter; otherwise it searches by name.
returnAlltoggleNofalseFetch every matching record by paginating automatically. When on, Limit is ignored.
limitnumberNo30Maximum number of records to return (for Customer Context, how many recent tickets). Gorgias caps this at 100. Ignored when Return All is on.

Inputs and outputs

Inputs are the configurable fields above. The block produces these outputs:

Outputs

Reference an output downstream with <Gorgias.field>.

NameTypeDescription
successbooleanOperation success status
ticketjsonSingle ticket (Get Ticket) (object — fields: id, subject, status, channel, via, customer, assignee, tags, created_datetime, updated_datetime)
ticketsarrayTickets (List Tickets, or recent tickets in Customer Context)
messagesarrayMessages on a ticket (List Messages)
customerjsonSingle customer (Get Customer / Customer Context) (object — fields: id, email, name, firstname, lastname, external_id, language, created_datetime, updated_datetime)
customersarrayMatching customers (Search Customers)
errorstringError message if failed

Example

A minimal configuration for this block:

{
  "type": "gorgias/manage",
  "config": {
    "resource": "ticket",
    "operation": "...",
    "returnAll": false,
    "limit": 30
  }
}

Limits and failure modes

  • Requires a connected Gorgias integration. Calls fail if that integration is disconnected or its authorization has expired.
  • Required fields (resource, operation) must be set, or the block fails validation before it runs.
  • On failure the error output is populated; downstream blocks that reference other outputs may not receive values.

On this page