--- title: Gorgias API Integration on Truto slug: gorgias category: Helpdesk canonical: "https://truto.one/integrations/detail/gorgias/" --- # Gorgias API Integration on Truto **Category:** Helpdesk **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### Unified Ticketing API - **Attachments** — Attachments are the files associated with a ticket or a comment. - **Collections** — Tickets and contacts can be grouped into Collections. Collection resource usually maps to the various grouping systems used in the underlying product. Some examples are lists, projects, epics, etc. You can differentiate between these grouping systems using the type attribute of a Collection. - **Comments** — Comments represent the communication happening on a Ticket, both between a User and a Contact and the internal things like notes, private comments, etc. A Ticket can have one or more Comments. - **Contacts** — Contact represent the external people you are in contact with. These could be customers, leads, etc. Contacts can be associated with an Account if the underlying product supports it. - **Fields** — Fields represent the attributes defined for various entities in the underlying product. Depending on the underlying product, custom attributes can be defined by a User on various entities like Ticket, Contact, etc. is_user_defined attribute within Field can be used to differentiate between custom and system defined Fields. - **Tags** — Tags represent a common classification approach used in various ticketing systems. A Ticket may have one or more Tags associated with them. - **Teams** — Teams represent the grouping system used for Users. These are usually called groups, teams, agent groups, etc. in the underlying products. A User can belong to one or more Teams. - **Tickets** — Core resource which represents some work that needs to be carried out. Tickets are usually mapped to issues, tasks, work items, etc. depending on the underlying product. - **Users** — Users represent the people using the underlying ticketing system. They are usually called agents, team members, admins, etc. ## MCP-ready AI tools Truto exposes 104 tools for Gorgias that AI agents can call directly. - **list_all_gorgias_users** — List users ordered by name in Gorgias. Returns id, active status, bio, created_datetime, country, deactivated_datetime, email, external_id, firstname, lastname, language, meta.name, role, timezone, and updated_datetime fields. - **get_single_gorgias_user_by_id** — Get information about a specific user in Gorgias by id. Use id 0 to fetch the current user. Returns user details including id, name, email, and role. - **create_a_gorgias_user** — Create a user in Gorgias with required email, name, and role. Returns id, active status, bio, created_datetime, country, email, external_id, firstname, lastname, language, meta, full name, role name, timezone, updated_datetime, and client_id. - **update_a_gorgias_user_by_id** — Update a user by id in Gorgias. Returns fields including id, active status, bio, created_datetime, country, email, external_id, firstname, lastname, language, meta data, full name, role name, timezone, updated_datetime, and client_id. - **delete_a_gorgias_user_by_id** — Delete a user by id in Gorgias. Returns no content on success. - **list_all_gorgias_tickets** — The List Tickets endpoint retrieves a paginated list of support tickets from your Gorgias account, ordered by a specified field using the order_by parameter. It supports several optional filters to narrow down the results, including customer_id, trashed, external_id, view_id, rule_id, and a list of specific ticket_ids. - **get_single_gorgias_ticket_by_id** — Get detailed information about a specific ticket in Gorgias by id. Returns ticket id, uri, external_id, status, channel, via, customer info, assignee_user, subject, tags, messages, timestamps, satisfaction_survey, and unread status. - **create_a_gorgias_ticket** — Create a ticket in Gorgias with required messages array. - **update_a_gorgias_ticket_by_id** — Update a ticket in Gorgias. Requires id. - **delete_a_gorgias_ticket_by_id** — Delete a ticket by id in Gorgias. Returns no content on success. - **list_all_gorgias_customers** — List customers ordered by name in Gorgias. Supports filtering by email, external_id, language, name, timezone, view_id, channel_type, and channel_address. Returns customer fields including id, email, external_id, firstname, lastname, name, language, timezone, created_datetime, and updated_datetime. - **get_single_gorgias_customer_by_id** — Get information about a specific customer in Gorgias by id. Returns fields including id, channels, created_datetime, email, external_id, firstname, integrations, language, lastname, name, note, timezone, updated_datetime, and external_data. - **create_a_gorgias_customer** — Create a customer in Gorgias with required channels. Returns id, channels, email, external_id, firstname, integrations data, language, lastname, name, note, timezone, created_datetime, and updated_datetime. - **update_a_gorgias_customer_by_id** — Update a customer by id in Gorgias. Returns the updated customer object including id, name, email, language, timezone, and channels. - **gorgias_customers_set_customer_data** — Set a customer's data in Gorgias by customer id. - **delete_a_gorgias_customer_by_id** — Delete a customer by id in Gorgias. - **list_all_gorgias_tags** — List tags matching the given parameters in Gorgias. Returns tag name and created_datetime fields. - **get_single_gorgias_tag_by_id** — Get information about a specific tag by id in Gorgias. Returns fields created_datetime, decoration, color, deleted_datetime, description, name, and usage. - **create_a_gorgias_tag** — Create a tag in Gorgias with the required name. Returns created_datetime, decoration (color), deleted_datetime, description, name, and usage count of the tag. - **update_a_gorgias_tag_by_id** — Update a tag by id in Gorgias. Returns fields including created_datetime, decoration, color, deleted_datetime, description, urgent, and usage. - **delete_a_gorgias_tag_by_id** — Delete a tag by id in Gorgias. Tags used in macros or rules cannot be deleted. Deleting a tag deactivates any views using it. - **gorgias_tags_merge** — Merge one or more source tags into the destination tag in Gorgias. Requires destination tag id and source_tags_ids. Returns the merged tag with fields like created_datetime, decoration, color, description, name, and usage. - **list_all_gorgias_messages** — List messages filtered by ticket_id in Gorgias. Returns id, external_id, ticket_id, message content, sender, and channel details for each message. - **get_single_gorgias_message_by_id** — Get a specific message by ticket_id and id in Gorgias. Returns fields including id, message_id, ticket_id, external_id, public, channel, via, source, sender, receiver, subject, body_text, body_html, attachments, created_datetime, sent_datetime, failed_datetime, opened_datetime, last_sending_error, and integration_id. - **create_a_gorgias_message** — Create a message in Gorgias for the ticket identified by ticket_id. Returns message fields including id, body_html, body_text, channel, created_datetime, external_id, from_agent, integration_id, message_id, receiver, sender, source, and subject. - **update_a_gorgias_message_by_id** — Update a message by ticket_id and id in Gorgias. Returns fields including id, attachments, body_html, body_text, channel, created_datetime, external_id, failed_datetime, from_agent, integration_id, last_sending_error, message_id, receiver, rule_id, sender, source, stripped_html, stripped_text, subject, and ticket_id. - **delete_a_gorgias_message_by_id** — Delete a message by ticket_id and id in Gorgias. - **list_all_gorgias_teams** — List teams with optional limit and order_by parameters in Gorgias. Returns an array of teams including id, name, description, decoration, members, and created_datetime fields. - **get_single_gorgias_team_by_id** — Get information about a specific team by id in Gorgias. Returns id, uri, name, description, decoration (emoji), members (id, name, email), and created_datetime fields. - **create_a_gorgias_team** — Create a team with the required name in Gorgias. Returns the id and name of the created team. - **update_a_gorgias_team_by_id** — Update a team by id in Gorgias. Returns the updated team's id, name, description, decoration, and members with their id, name, and email. - **list_all_gorgias_ticket_tags** — Get all tags for a ticket in Gorgias. Requires ticket id. Returns tag id, created_datetime, decoration color, deleted_datetime, description, name, usage count, and uri. - **create_a_gorgias_ticket_tag** — Add tags to a ticket in Gorgias. Requires ticket_id. - **update_a_gorgias_ticket_tag_by_id** — Set a ticket's tags by ticket_id in Gorgias. The response confirms the update with no content returned. - **delete_a_gorgias_ticket_tag_by_id** — Remove tags from a ticket in Gorgias. Requires ticket id and tag names or ids. Returns no content on success. - **list_all_gorgias_attachments** — Retrieves a list of messages, each of which may contain attachments. This endpoint is used to access message data, including associated attachments metadata - **gorgias_attachments_download** — Downloads a specific attachment file using the file's direct path, which is typically provided in the response of the message listing endpoint. The actual path must be replaced with the URI or download link of the attachment. - **list_all_gorgias_views** — List all views ordered by their id in Gorgias. Returns fields including id, category, created_datetime, deactivated_datetime, decoration, fields, filters, name, order_by, order_dir, search, slug, type, and visibility. - **get_single_gorgias_view_by_id** — Get a view by id in Gorgias. Returns fields including id, category, created_datetime, deactivated_datetime, decoration (emoji), fields, filters, name, order_by, order_dir, search, slug, and type. - **create_a_gorgias_view** — Create a view in Gorgias with required slug. Returns id, category, created_datetime, deactivated_datetime, decoration (emoji), fields (attributes displayed), filters (filter logic), name, order_by, order_dir, search, slug, type, visibility. - **update_a_gorgias_view_by_id** — Update a view by id in Gorgias. Returns the updated view including id, category, created_datetime, deactivated_datetime, decoration (emoji), fields, filters, name, order_by, order_dir, search, slug, type, shared_with_teams, shared_with_users, uri, and visibility. - **delete_a_gorgias_view_by_id** — Delete a view by id in Gorgias. Requires the id of the view to delete. - **list_all_gorgias_view_items** — List items of a view by view_id in Gorgias. Returns paginated items ordered by view's attribute including id, subject, customer, assignee_user, assignee_team, tags, status, priority, channel, and timestamps. - **create_a_gorgias_file** — Upload files to Gorgias with type parameter specifying file type. Returns content_type, name, size, and url of each uploaded file. - **gorgias_files_download** — Download a private file by file_type, domain_hash, and id in Gorgias. Returns the file content for the specified resource_name. - **list_all_gorgias_custom_fields** — List custom fields filtered by object_type in Gorgias. Returns id, external_id, object_type, label, description, priority, required, managed_type, definition, created_datetime, updated_datetime, and deactivated_datetime for each custom field. - **get_single_gorgias_custom_field_by_id** — Get information about a specific custom field in Gorgias. Requires id. Returns fields including id, label, and type of the custom field. - **create_a_gorgias_custom_field** — Create a custom field in Gorgias with required object_type and label. Returns id, external_id, object_type, label, description, priority, required, managed_type, definition.input_settings, created_datetime, updated_datetime, and deactivated_datetime. - **update_a_gorgias_custom_field_by_id** — Update a custom field by id in Gorgias. Returns the updated custom field including id, label, description, data_type, and priority. - **update_a_gorgias_ticket_field_by_id** — Update a ticket's custom fields values in Gorgias. Requires ticket_id. Returns the updated custom fields. - **list_all_gorgias_ticket_fields** — List all custom fields for a ticket in Gorgias. Requires ticket id. Returns fields including id, external_id, label, description, required status, data_type, and timestamps. - **list_all_gorgias_integrations** — List integrations with optional parameters order_by, and type in Gorgias. Returns integration id, name, type, description, created_datetime, updated_datetime, deactivated_datetime, and HTTP integration details including url, method, triggers, and content types. - **get_single_gorgias_integration_by_id** — Get integration details by id in Gorgias. Returns id, name, type, created_datetime, updated_datetime, and http configuration including url, method, form data, triggers, request_content_type, and response_content_type. - **create_a_gorgias_integration** — Create an integration in Gorgias with required name and type. Returns id, created_datetime, updated_datetime, uri, and http configuration including url, method, form data, triggers, request_content_type, and response_content_type. - **update_a_gorgias_integration_by_id** — Update an integration by id in Gorgias. Returns the updated integration including id, created_datetime, deactivated_datetime, description, http configuration, name, type, updated_datetime, user, uri, application_id, and managed status. - **delete_a_gorgias_integration_by_id** — Delete an integration by id in Gorgias. Note that integrations used in rules or other integrations cannot be deleted. Deleting will deactivate any views using this integration. - **list_all_gorgias_macros** — List macros with parameters tags, languages, message_id, order_by, search, ticket_id, number_predictions, and archived in Gorgias. Returns id, external_id, name, intent, language, usage, actions, created_datetime, updated_datetime, archived_datetime, and uri fields. - **create_a_gorgias_macro** — Create a macro in Gorgias with required name, and optional external_id, intent, language, and actions. Returns id, external_id, name, intent, language, usage, actions, created_datetime, updated_datetime, archived_datetime, and uri. - **get_single_gorgias_macro_by_id** — Get information about a specific macro in Gorgias by id. Returns fields including id, external_id, name, intent, language, usage, actions, created_datetime, updated_datetime, archived_datetime, and uri. - **update_a_gorgias_macro_by_id** — Update a macro by id in Gorgias. Returns id, external_id, name, intent, language, usage, actions, created_datetime, updated_datetime, archived_datetime, and uri fields in the response. - **delete_a_gorgias_macro_by_id** — Delete a macro by id in Gorgias. Requires id. - **update_a_gorgias_customer_field_by_id** — Update a customer's custom fields values in Gorgias using customer_id. Returns updated fields including id, external_id, label, description, required status, data_type, and timestamps. - **list_all_gorgias_search** — Search resources in Gorgias using type and query. Returns matching resource fields such as id, name, and email in the response. - **get_single_gorgias_account_by_id** — Get information about your account in Gorgias. Returns created_datetime, deactivated_datetime, domain, settings (including business hours), and status indicating if the account is active. - **list_all_gorgias_account_settings** — List account settings in Gorgias filtered by type. Returns id, data including timezone and business_hours, and type for each setting. - **create_a_gorgias_account_setting** — Create a setting for the current account in Gorgias. Requires type and data in the request body. - **update_a_gorgias_account_setting_by_id** — Update a setting for the current account in Gorgias using id. - **list_all_gorgias_surveys** — List surveys in Gorgias ordered by creation date. Returns id, body_text, created_datetime, customer_id, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, uri, and meta fields. - **get_single_gorgias_survey_by_id** — Get a survey in Gorgias by id. Returns id, body_text, created_datetime, customer_id, meta, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri in the response. - **create_a_gorgias_survey** — Create a new satisfaction survey in Gorgias with required parameters customer_id and ticket_id. Returns id, body_text, created_datetime, customer_id, meta, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri. - **update_a_gorgias_survey_by_id** — Update a survey in Gorgias using id. Returns id, body_text, created_datetime, customer_id, meta, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri in the response. - **list_all_gorgias_jobs** — List jobs in Gorgias ordered by creation date. Returns id, status, type, created_datetime, user_id, and progress info for each job. - **get_single_gorgias_job_by_id** — Get details about a specific job in Gorgias using id. Returns fields such as id, status, type, created_datetime, user_id, and job progress info. - **create_a_gorgias_job** — Create a job in Gorgias with specified type and params. Returns id, status, type, created_datetime, user_id, and job progress fields in the response. Jobs are processed asynchronously, meaning that once a job is created, it will run in background on Gorgias's servers. According to the type and size of the task, a job can take a few minutes or several hours to be executed. You can use our API to check the status of the job. - **update_a_gorgias_job_by_id** — Update a job in Gorgias using id. Returns fields such as id, status, meta, params, scheduled_datetime, and info for tracking job status and details. - **delete_a_gorgias_job_by_id** — Cancel a job in Gorgias. Requires id. Returns no content if successful. If the job already started, completed changes will not be reverted. - **list_all_gorgias_rules** — List rules in Gorgias. Returns id, code, code_ast, created_datetime, deactivated_datetime, description, event_types, name, priority, updated_datetime, and uri for each rule. - **get_single_gorgias_rule_by_id** — Get a specific rule in Gorgias using id. Returns id, code, code_ast, created_datetime, deactivated_datetime, description, event_types, name, priority, updated_datetime, and uri fields in the response. - **create_a_gorgias_rule** — Create a rule in Gorgias. Requires code and name. Returns id, code, code_ast, created_datetime, deactivated_datetime, description, event_types, name, priority, updated_datetime, and uri in the response. - **update_a_gorgias_rule_by_id** — Update a rule in Gorgias using id. Returns id, code (JavaScript logic), code_ast (AST representation), created_datetime, deactivated_datetime, description, event_types, name, priority, updated_datetime, and uri in the response. - **delete_a_gorgias_rule_by_id** — Delete a rule in Gorgias. Requires id. Returns no content in the response. - **gorgias_rules_update_priorities** — Update priorities for multiple rules in Gorgias. Requires an array of objects with id and priority. Returns id, code, code_ast, created_datetime, deactivated_datetime, description, event_types, name, priority, updated_datetime, and uri for each updated rule. - **list_all_gorgias_events** — List events filtered by created_datetime, object_id, object_type, and types in Gorgias. Returns event id, created_datetime, type, user_id, and uri fields ordered by creation date descending. - **get_single_gorgias_event_by_id** — Get information about a specific event in Gorgias by id. Returns event fields including id, context (uuid4 grouping related events), created_datetime, data (key-value), object_id, object_type, type, user_id, and uri. - **list_all_gorgias_satisfaction_survey** — List satisfaction surveys filtered by ticket_id in Gorgias. Returns id, body_text, created_datetime, customer_id, score, scored_datetime, sent_datetime, should_send_datetime, and ticket_id for each survey. - **get_single_gorgias_satisfaction_survey_by_id** — Get a satisfaction survey by id in Gorgias. Returns id, body_text (customer comment), created_datetime, customer_id, meta (additional data), score (1-5 satisfaction level), scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri. - **create_a_gorgias_satisfaction_survey** — Create a new satisfaction survey in Gorgias with required parameters customer_id and ticket_id. Returns id, body_text, created_datetime, customer_id, meta, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri of the created survey. - **update_a_gorgias_satisfaction_survey_by_id** — Update a satisfaction survey by id in Gorgias. Returns the updated survey including id, body_text, created_datetime, customer_id, meta, score, scored_datetime, sent_datetime, should_send_datetime, ticket_id, and uri. - **list_all_gorgias_statistics** — Retrieve the data of a statistic by name in Gorgias. Requires name and filters. Returns data with axes and lines representing the statistic, along with label and legend fields describing the metric. - **gorgias_statistics_download** — Download CSV-formatted data of a statistic in Gorgias. Requires name of the statistic and filters object. Returns CSV data for the specified statistic. - **list_all_gorgias_voice_calls** — List voice calls filtered by ticket_id in Gorgias. Returns id, integration_id, ticket_id, phone_number_id, external_id, provider, status, direction, phone_number_source, country_source, phone_number_destination, country_destination, duration, started_datetime, created_datetime, updated_datetime, initiated_by_agent_id, last_answered_by_agent_id, customer_id, has_voicemail, has_call_recording, summaries, termination_status, and queue_id fields. - **get_single_gorgias_voice_call_by_id** — Get information about a specific voice call in Gorgias by id. Returns fields including id, integration_id, ticket_id, phone_number_id, external_id, provider, status, direction, phone_number_source, country_source, phone_number_destination, country_destination, duration, started_datetime, created_datetime, updated_datetime, initiated_by_agent_id, last_answered_by_agent_id, customer_id, has_voicemail, has_call_recording, termination_status, and queue_id. - **list_all_gorgias_voice_call_recordings** — List voice call recordings in Gorgias filtered by optional call_id. Returns id, call_id, external_id, url, duration, type, created_datetime, deleted_datetime, error_code, and transcription_status for each recording. - **get_single_gorgias_voice_call_recording_by_id** — Get a voice call recording by id in Gorgias. Returns id, call_id, external_id, url, duration, type, created_datetime, deleted_datetime, error_code, and transcription_status fields. - **delete_a_gorgias_voice_call_recording_by_id** — Delete a voice call recording by id in Gorgias. Returns no content if successful. - **list_all_gorgias_voice_call_events** — List voice call events in Gorgias. Returns fields id, type, account_id, call_id, user_id, customer_id, created_datetime, and meta for each event. - **get_single_gorgias_voice_call_event_by_id** — Get information about a specific voice call event in Gorgias using id. Returns id, type, account_id, call_id, user_id, customer_id, created_datetime, and meta fields. - **list_all_gorgias_widgets** — List all widgets in Gorgias. Returns id, context, created_datetime, deactivated_datetime, app_id, order, template (type, widgets), type, updated_datetime, and uri for each widget. - **get_single_gorgias_widget_by_id** — Get information about a specific widget in Gorgias. Requires id. Returns id, context (ticket, customer), created_datetime, deactivated_datetime, app_id, order, template (type and widgets), type, updated_datetime, and uri. - **create_a_gorgias_widget** — Create a widget in Gorgias with required template and type. Returns id, context, created_datetime, deactivated_datetime, app_id, order, template, type, updated_datetime, and uri of the created widget. - **update_a_gorgias_widget_by_id** — Update a widget by id in Gorgias. Returns the updated widget including id, context, created_datetime, deactivated_datetime, app_id, order, template with type and widgets, type, updated_datetime, and uri. - **delete_a_gorgias_widget_by_id** — Delete a widget by id in Gorgias. Returns no content on success. - **list_all_gorgias_view_items_search** — List view's items for view with id in Gorgias. Returns items with fields including id, subject, customer info, assignee user and team, tags, status, priority, channel, and timestamps. Requires view_id and view object in body. - **update_a_gorgias_ticket_field_value_by_id** — Update a specific ticket's custom field value in Gorgias. Requires ticket_id and id. Returns field details including id, definition, label, and updated value in the response. ## How it works 1. **Link your customer's Gorgias account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Gorgias.** The Proxy API is a 1-to-1 mapping of the Gorgias API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed your SaaS data directly inside Gorgias tickets** — If your product serves e-commerce merchants, embedding a sidebar widget in Gorgias lets support agents see your data and take action without leaving the helpdesk. Truto handles the widget creation and update lifecycle via the Gorgias Widgets API so you can ship this integration fast. - **Automatically create tickets from external events** — SaaS platforms that detect critical events — failed subscription payments, negative reviews, shipping exceptions — can use Truto to create Gorgias tickets with full context and message history, routing them to the right team for immediate human attention. - **Enrich Gorgias customer profiles with your product data** — Sync customer-level data like loyalty tier, subscription status, or return history into Gorgias custom fields so agents have a complete picture at a glance. This also powers Gorgias's native rules engine for automated routing and macro triggers. - **Tag and route tickets based on your product's intelligence** — Apply tags like 'high-churn-risk' or 'active-return' to Gorgias tickets programmatically, enabling merchants to build automation rules that trigger macros, assign teams, or auto-respond — all driven by signals from your SaaS. - **Sync voice and telephony data into the Gorgias timeline** — Cloud telephony and AI voice bot platforms can push call logs, recordings, and transcripts into Gorgias so every customer interaction lives in one place. Truto provides access to voice calls, recordings, and call events endpoints. ## What you can build - **In-ticket sidebar widget with actionable buttons** — Use the Widgets API to render your SaaS data — loyalty points, return status, subscription details — inside Gorgias tickets with buttons that call back to your own API for one-click actions. - **Event-driven ticket creation with full conversation history** — Automatically create Gorgias tickets and append message threads when your product detects an event that needs human support, complete with tags and team assignment for instant routing. - **Two-way ticket sync via Unified Ticketing API** — Use Truto's Unified Ticketing API to read, create, and update Gorgias tickets, comments, contacts, tags, and teams with the same code you use for other helpdesks. - **Custom field sync for customer and ticket enrichment** — Define and populate custom fields on Gorgias customer and ticket objects — like RMA numbers, subscription plan, or LTV score — that agents and automation rules can reference instantly. - **Automated tagging engine for macro triggers** — Programmatically apply and manage ticket tags based on your product's signals so merchants can wire up Gorgias macros and rules without manual configuration. - **Call log and recording sync for telephony platforms** — List and retrieve voice call data, recordings, and call events from Gorgias to build unified reporting or push your platform's call data into the customer timeline. ## FAQs ### What authentication method does the Gorgias integration use? Gorgias supports API key-based authentication tied to a specific Gorgias account subdomain. Truto manages credential storage and request signing so your end users connect their accounts through a hosted auth flow without you handling secrets directly. ### Which Truto Unified APIs map to Gorgias? Gorgias is available through the Unified Ticketing API (covering Tickets, Comments, Contacts, Tags, Teams, Attachments, Fields, Collections, and Users) and the Unified User Directory API (Users). You can use the same schema to read and write Gorgias data as you would for any other helpdesk Truto supports. ### Can I create and manage custom fields on both tickets and customers? Yes. Truto exposes endpoints to create custom fields, list them, and update field values on both ticket and customer objects — including update_a_gorgias_ticket_field_value_by_id and update_a_gorgias_customer_field_by_id — so you can enrich records with your product's data. ### Does Truto handle pagination and rate limits for Gorgias? Yes. Truto abstracts Gorgias's cursor-based pagination and respects its rate limits automatically, so you get consistent page-based iteration across all list endpoints without building retry or throttle logic yourself. ### Can I embed a custom widget inside the Gorgias agent UI? Yes. The integration supports creating, updating, reading, and deleting widgets via the Gorgias Widgets API. This lets you render HTML content and action buttons directly in the Gorgias ticket sidebar. ### What ticket-related operations are supported beyond basic CRUD? Beyond creating, reading, updating, and deleting tickets, you can manage ticket tags, messages, attachments, custom field values, views, view items, and search across tickets. You can also manage macros, rules, rule priorities, integrations, surveys, satisfaction surveys, statistics, and jobs.