gorgias

name	gorgias
description	Gorgias e-commerce helpdesk API integration with managed OAuth. Create and manage support tickets, handle customer data, organize teams, and manage account settings. Use this skill when users want to search support tickets, update customer information, manage helpdesk teams, or create new support tickets.

Gorgias

Manage your e-commerce helpdesk from chat -- create and update tickets, manage customer data, organize support teams, and configure account settings. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Gorgias
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Gorgias

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Gorgias API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. List support tickets
clawlink_call_tool({ tool: "gorgias_list_tickets", parameters: {} })

// 2. Get a specific customer
clawlink_call_tool({ tool: "gorgias_get_customer", parameters: { customer_id: "12345" } })

// 3. Create a new ticket
clawlink_call_tool({ tool: "gorgias_create_ticket", parameters: { subject: "Order inquiry", customer_id: "12345" } })

Authentication

ClawLink handles OAuth with Gorgias. No API keys needed. Connect at claw-link.dev/dashboard?add=gorgias.

Connection Management

// List connections
clawlink_list_integrations()

// Verify by fetching account info
clawlink_call_tool({ tool: "gorgias_get_account", parameters: {} })

Security & Permissions

• Read tools are safe and require no confirmation
• Write tools require confirmation before execution
• Delete and merge operations are high-impact and irreversible

Tool Reference

Ticket Operations

Tool	Description	Mode
gorgias_list_tickets	List tickets with filtering options	Read
gorgias_get_ticket	Get a specific ticket by ID	Read
gorgias_create_ticket	Create a new support ticket	Write
gorgias_update_ticket	Update an existing ticket	Write
gorgias_delete_ticket	Delete a specific ticket	Write
gorgias_add_ticket_tags	Add tags to a ticket	Write
gorgias_remove_ticket_tags	Remove tags from a ticket	Write
gorgias_set_ticket_tags	Replace all tags on a ticket	Write
gorgias_list_ticket_tags	List all tags for a ticket	Read
gorgias_list_ticket_field_values	List field values for a ticket	Read
gorgias_delete_ticket_field_value	Delete a specific ticket field value	Write

Customer Operations

Tool	Description	Mode
gorgias_list_customers	List customers with filtering	Read
gorgias_get_customer	Get a specific customer by ID	Read
gorgias_create_customer	Create a new customer	Write
gorgias_update_customer	Update an existing customer	Write
gorgias_delete_customer	Delete a specific customer	Write
gorgias_delete_customers	Delete multiple customers	Write
gorgias_merge_customers	Merge two customers into one	Write
gorgias_set_customer_data	Set complete data object for a customer	Write
gorgias_list_customer_field_values	List field values for a customer	Read
gorgias_delete_customer_field_value	Delete a specific customer field value	Write

Event Operations

Tool	Description	Mode
gorgias_list_events	List events with filtering options	Read
gorgias_get_event	Get a specific event by ID	Read

Team Operations

Tool	Description	Mode
gorgias_list_teams	List all teams	Read
gorgias_get_team	Get a specific team by ID	Read
gorgias_create_team	Create a new team	Write
gorgias_update_team	Update an existing team	Write
gorgias_delete_team	Delete a specific team	Write

Account Operations

Tool	Description	Mode
gorgias_get_account	Get Gorgias account information	Read
gorgias_list_account_settings	List all account settings	Read
gorgias_create_account_setting	Create a new account setting	Write
gorgias_update_account_setting	Update an existing account setting	Write

Code Examples

Example 1: Ticket management

// List open tickets
const tickets = await clawlink_call_tool({
  tool: "gorgias_list_tickets",
  parameters: { status: "open", limit: 10 }
});

// Update a ticket
await clawlink_call_tool({
  tool: "gorgias_update_ticket",
  parameters: {
    ticket_id: "67890",
    status: "closed",
    comment: "Resolved via automated workflow."
  }
});

Example 2: Customer lookup and update

// Find a customer
const customers = await clawlink_call_tool({
  tool: "gorgias_list_customers",
  parameters: { email: "[e-mail]" }
});

// Update customer data
await clawlink_call_tool({
  tool: "gorgias_update_customer",
  parameters: {
    customer_id: "12345",
    name: "Jane Smith",
    data: { vip: true }
  }
});

Example 3: Team and ticket tags

// Add tags to a ticket
await clawlink_call_tool({
  tool: "gorgias_add_ticket_tags",
  parameters: {
    ticket_id: "67890",
    tags: ["urgent", "billing"]
  }
});

// List teams
const teams = await clawlink_call_tool({
  tool: "gorgias_list_teams",
  parameters: {}
});

Discovery Workflow

1. Call clawlink_list_integrations to confirm gorgias is connected.
2. Call clawlink_list_tools --integration gorgias to see the live catalog.
3. Use clawlink_search_tools({ query: "ticket", integration: "gorgias" }) to find specific tools.

Execution Workflow

READ (safe):     list_tickets → get_customer → list_teams → list_events
WRITE (confirm): create_ticket → update_customer → add_ticket_tags → create_team
DELETE (high):   delete_ticket → delete_customer → merge_customers → delete_team

Notes

• Merging customers combines their data and ticket history permanently
• Customer and ticket field values can be managed independently
• Account settings control helpdesk behavior and integrations

Error Handling

Status / Error	Meaning
401 Unauthorized	OAuth token expired -- reconnect at dashboard
403 Forbidden	Insufficient permissions for this action
404 Not Found	Ticket, customer, or team ID does not exist
409 Conflict	Duplicate customer or ticket
429 Rate Limited	Too many requests -- apply exponential backoff

Troubleshooting

Tools Not Visible

• Start a fresh OpenClaw chat to reload plugin catalog
• Call clawlink_list_integrations to confirm pairing

Invalid Tool Call

• Verify customer and ticket IDs are numeric
• Use gorgias_list_tickets to confirm valid ticket IDs
• Tag names must match existing tags in the helpdesk

Resources

• Gorgias API Docs: https://developers.gorgias.com/
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=gorgias
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw