Skip to main content
Server path: /gorgias-tickets | Type: Application | PCID required: Yes

Tools

ToolDescription
gorgias_tickets_create_satisfaction_surveyCreate a survey
gorgias_tickets_create_tagCreate a tag
gorgias_tickets_create_ticketCreate a ticket
gorgias_tickets_create_ticket_messageCreate a message
gorgias_tickets_create_ticket_tagsAdd ticket tags
gorgias_tickets_delete_tagDelete a tag
gorgias_tickets_delete_tagsDelete tags
gorgias_tickets_delete_ticketDelete a ticket
gorgias_tickets_delete_ticket_custom_fieldDelete ticket field value
gorgias_tickets_delete_ticket_messageDelete a message
gorgias_tickets_delete_ticket_tagsRemove ticket tags
gorgias_tickets_delete_voice_call_recordingDelete a voice call recording
gorgias_tickets_get_api_tickets_ticket_id_tagsList ticket tags
gorgias_tickets_get_satisfaction_surveyRetrieve a survey
gorgias_tickets_get_tagRetrieve a tag
gorgias_tickets_get_ticketRetrieve a ticket
gorgias_tickets_get_ticket_messageRetrieve a message
gorgias_tickets_get_voice_callRetrieve a voice call
gorgias_tickets_get_voice_call_eventRetrieve a voice call event
gorgias_tickets_get_voice_call_recordingRetrieve a voice call recording
gorgias_tickets_list_messagesList messages
gorgias_tickets_list_satisfaction_surveysList surveys
gorgias_tickets_list_tagsList tags
gorgias_tickets_list_ticket_custom_fieldsList ticket field values
gorgias_tickets_list_ticketsList tickets
gorgias_tickets_list_voice_call_eventsList voice call events
gorgias_tickets_list_voice_call_recordingsList voice call recordings
gorgias_tickets_list_voice_callsList voice calls
gorgias_tickets_merge_tagsMerge tags
gorgias_tickets_update_satisfaction_surveyUpdate a survey
gorgias_tickets_update_tagUpdate a tag
gorgias_tickets_update_ticketUpdate a ticket
gorgias_tickets_update_ticket_custom_fieldUpdate ticket field value
gorgias_tickets_update_ticket_custom_fieldsUpdate ticket fields values
gorgias_tickets_update_ticket_messageUpdate a message
gorgias_tickets_update_ticket_tagsSet ticket tags

gorgias_tickets_create_satisfaction_survey

Create a survey Parameters:
ParameterTypeRequiredDefaultDescription
body_textstringNoThe comment sent by the customer.
created_datetimestringNoWhen the survey was created.
customer_idintegerYesThe ID of the customer who filled the survey.
metaobjectNoData associated with the satisfaction survey. You can use this parameter to store structured information (key-value data) about the satisfaction survey. This field is not used by Gorgias.
scoreintegerNoThe level of satisfaction. Scores range from 1 to 5.
scored_datetimestringNoWhen the survey was filled by the customer.
sent_datetimestringNoWhen the survey was sent. If is not set it means that it was not sent yet.
should_send_datetimestringNoWhen the survey should be sent. If not set then the survey will not be sent by Gorgias.
ticket_idintegerYesThe ID of the ticket the survey is associated with.

gorgias_tickets_create_tag

Create a tag Parameters:
ParameterTypeRequiredDefaultDescription
decorationobjectNoInformation related to the style of the tag.
descriptionstringNoShort description of the tag.
namestringYesName of the tag. Tags’ names are case sensitive.

gorgias_tickets_create_ticket

Create a ticket Parameters:
ParameterTypeRequiredDefaultDescription
assignee_teamobjectNoTeam assigned to the ticket
assignee_userobjectNoUser assigned to this ticket
channelobjectNoChannel used to initiate the conversation with the customer
closed_datetimestringNoWhen the ticket was closed
created_datetimestringNoWhen the ticket was created
custom_fieldsobject[]NoCustom fields associated with the ticket
customerobjectNoCustomer associated with the ticket
external_idstringNoID of the ticket in a foreign system. This field is not used by Gorgias, feel free to set it as you wish.
from_agentbooleanNoWhether the first message of the ticket was sent by your company to a customer, or the opposite
languagestringNoLanguage primarily used in the ticket. The language is automatically detected on the first messages by Gorgias if not set explicitly. Once the language has been set, it won’t be updated according to future messages.
last_message_datetimestringNoWhen the last message was sent
last_received_message_datetimestringNoWhen the last customer’s message was received
messagesobject[]YesMessages of the ticket
metaobjectNoMetadata associated with the ticketYou can use this field to store structured information (key-value data) about the ticket
opened_datetimestringNoWhen the ticket was opened for the first time by a User
prioritystringNoThe priority value
snooze_datetimestringNoWhen the ticket will be re-opened automatically
spambooleanNoWhether the ticket is considered as spam
statusstringNoThe status value
subjectstringNoSubject of the ticket
tagsobject[]NoThe tags associated with the ticket
trashed_datetimestringNoWhen the ticket was moved to the trash
updated_datetimestringNoWhen the ticket was lastly updated
viastringYesThe via value

gorgias_tickets_create_ticket_message

Create a message Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket to create a message in.
actionstringNoPolicy applied on external actions associated with the message if they failed. Three actions are possible: - force: bypass the failed action and try to execute the remaining one and to send the message - retry: retry the failed action - cancel: delete the TicketMessage
actionsany[]NoActions associated with the message
attachmentsobject[]NoAttachments associated with the message
body_htmlstringNoHTML version of the body of the message
body_textstringNoText version of the body of the message
channelobjectYesChannel used to send the message
created_datetimestringNoWhen the message was created
deleted_datetimestringNoWhen the message was deleted
external_idstringNoID of the message in a foreign system (Aircall, Zendesk, etc…). This field is not used by Gorgias, feel free to set it as you wish.
failed_datetimestringNoWhen the message failed to be sent. Messages that couldn’t be sent can be resend.
from_agentbooleanYesWhether the message was sent by your company
headersobjectNoHeaders of the message
integration_idintegerNoID of the Integration used to send the message
last_sending_errorobjectNoDetails of the last error encountered when Gorgias attempted to send the message
macrosobject[]NoMacros used to compose the message
mention_idsinteger[]NoList of User IDs to mention along with the internal note.
message_idstringNoID of the message on the service that send the message. It can be the ID of an email, a Messenger message, a Facebook comment, etc…
metaobjectNoMetadata associated with the ticket.You can use this field to store structured information (key-value data) about the ticket.
opened_datetimestringNoWhen the message was seen by their recipient
publicbooleanNoWhether the message is public. Only internal notes are private.
receiverobjectNoPrimary receiver of the message. It can be a user or a customer. Optional when the source type is “internal-note”.
senderobjectNoPerson who sent the message. It can be a user or a customer.
sent_datetimestringNoWhen the message was sent. If ommited, the message will be sent by Gorgias.
sourceobjectNoInformation used to route the message. It contains the names and the addresses of the sender and receivers.
stripped_htmlstringNoHTML version of the body of the message without email signatures and previous replies.
stripped_signaturestringNosignature stripped from the body of the message
stripped_textstringNoText version of the body of the message without email signatures and previous replies.
subjectstringNoSubject of the message
viastringYesThe via value

gorgias_tickets_create_ticket_tags

Add ticket tags Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
idsinteger[]NoThe IDs of the tags.
namesstring[]NoThe names of the tags.

gorgias_tickets_delete_tag

Delete a tag Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the tag to delete.

gorgias_tickets_delete_tags

Delete tags Parameters:
ParameterTypeRequiredDefaultDescription
idsinteger[]YesIDs of the tags to delete

gorgias_tickets_delete_ticket

Delete a ticket Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the ticket to delete.

gorgias_tickets_delete_ticket_custom_field

Delete ticket field value Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
idintegerYesThe ID of the custom field.

gorgias_tickets_delete_ticket_message

Delete a message Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket associated with the message.
idintegerYesThe ID of the message to delete.

gorgias_tickets_delete_ticket_tags

Remove ticket tags Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
idsinteger[]NoThe IDs of the tags.
namesstring[]NoThe names of the tags.

gorgias_tickets_delete_voice_call_recording

Delete a voice call recording Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the voice call recording to delete.

gorgias_tickets_get_api_tickets_ticket_id_tags

List ticket tags Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.

gorgias_tickets_get_satisfaction_survey

Retrieve a survey Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the survey to retrieve.

gorgias_tickets_get_tag

Retrieve a tag Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the tag to retrieve.

gorgias_tickets_get_ticket

Retrieve a ticket Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the ticket to retrieve.
relationshipsstring[]NoNames of relations that should be included in returned data.

gorgias_tickets_get_ticket_message

Retrieve a message Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket associated with the message.
idintegerYesThe ID of the message to retrieve.

gorgias_tickets_get_voice_call

Retrieve a voice call Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the voice call to retrieve.

gorgias_tickets_get_voice_call_event

Retrieve a voice call event Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the voice event to retrieve.

gorgias_tickets_get_voice_call_recording

Retrieve a voice call recording Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the voice call recording to retrieve.

gorgias_tickets_list_messages

List messages Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all messages. If omitted, the first messages of the list will be returned.
limitintegerNoMaximum number of messages to return.
order_bystringNoAttribute used to order messages.
ticket_idintegerNoThe ID of the ticket the messages are associated with.

gorgias_tickets_list_satisfaction_surveys

List surveys Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all satisfaction surveys. If omitted, the first satisfaction survey of the list will be returned.
limitintegerNoMaximum number of satisfaction surveys to return.
order_bystringNoAttribute used to order satisfaction surveys.
ticket_idintegerNoThe ID of the ticket the satisfaction surveys are associated with.

gorgias_tickets_list_tags

List tags Parameters:
ParameterTypeRequiredDefaultDescription
order_bystringNoOrder tags by the given attribute.<br>Values <span style=“color:red”>name, created_datetime, name, usage have been deprecated</span>. Use values with :asc or :desc instead.
searchstringNoSearch for tags’ names matching the given text query (case insensitive).
cursorstringNoValue indicating your position in the list of all items. If omitted, the first items of the list will be returned.
limitintegerNoMaximum number of items to return.

gorgias_tickets_list_ticket_custom_fields

List ticket field values Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.

gorgias_tickets_list_tickets

List tickets Parameters:
ParameterTypeRequiredDefaultDescription
order_bystringNoAttribute used to order tickets.
cursorstringNoValue indicating your position in the list of all tickets. If omitted, the first tickets of the list will be returned.
customer_idintegerNoThe ID of a customer used to select their tickets.
trashedbooleanNoWhether to include trashed tickets in the response.
external_idstringNoID of the ticket in a foreign system you’re looking for.
limitintegerNoMaximum number of tickets to return.
view_idintegerNoThe ID of a view used to select tickets matching the filters of this one.
rule_idintegerNoThe ID of a rule used to select tickets matching the filters of this one.
ticket_idsinteger[]NoThe IDs of tickets to select.

gorgias_tickets_list_voice_call_events

List voice call events Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all items. If omitted, the first items of the list will be returned.
limitintegerNoMaximum number of items to return.
call_idintegerNoCall Id

gorgias_tickets_list_voice_call_recordings

List voice call recordings Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all items. If omitted, the first items of the list will be returned.
limitintegerNoMaximum number of items to return.
call_idintegerNoCall Id

gorgias_tickets_list_voice_calls

List voice calls Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all items. If omitted, the first items of the list will be returned.
limitintegerNoMaximum number of items to return.
ticket_idintegerNoTicket Id

gorgias_tickets_merge_tags

Merge tags Parameters:
ParameterTypeRequiredDefaultDescription
destination_tag_idintegerYesThe ID of the tag that will serve as base for the merge.
source_tags_idsinteger[]NoIDs of the tags that will be merged into the destination tag.

gorgias_tickets_update_satisfaction_survey

Update a survey Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the survey to update.
body_textstringNoThe comment sent by the customer.
created_datetimestringNoWhen the survey was created.
customer_idintegerNoThe ID of the customer who filled the survey.
metaobjectNoData associated with the satisfaction survey. You can use this parameter to store structured information (key-value data) about the satisfaction survey. This field is not used by Gorgias.
scoreintegerNoThe level of satisfaction. Scores range from 1 to 5.
scored_datetimestringNoWhen the survey was filled by the customer.
sent_datetimestringNoWhen the survey was sent. If is not set it means that it was not sent yet.
should_send_datetimestringNoWhen the survey should be sent. If not set then the survey will not be sent by Gorgias.
ticket_idintegerNoThe ID of the ticket the survey is associated with.

gorgias_tickets_update_tag

Update a tag Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the tag to update.
decorationobjectNoInformation related to the style of the tag.
descriptionstringNoShort description of the tag.
namestringNoName of the tag. Tags’ names are case sensitive.

gorgias_tickets_update_ticket

Update a ticket Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the ticket to update.
assignee_teamobjectNoThe team to assign to the ticket
assignee_userobjectNoThe user to assign to the ticket
channelobjectNoChannel used to initiate the conversation with the customer
closed_datetimestringNoWhen the ticket was closed
custom_fieldsobject[]NoCustom fields associated with the ticket
customerobjectNoThe customer value
external_idstringNoID of the ticket in a foreign system. This field is not used by Gorgias, feel free to set it as you wish.
from_agentbooleanNoWhether the first message of the ticket was sent by your company to a customer, or the opposite
is_unreadbooleanNoMark the ticket as read/unread
languagestringNoLanguage primarily used in the ticket
last_message_datetimestringNoWhen the last message was sent
last_received_message_datetimestringNoWhen the last customer’s message was received
metaobjectNoMetadata associated with the ticketYou can use this field to store structured information (key-value data) about the ticket
opened_datetimestringNoPriority of the ticket
prioritystringNoThe priority value
snooze_datetimestringNoWhen the ticket will be re-opened automatically
spambooleanNoWhether the ticket is considered as spam
statusstringNoThe status value
subjectstringNoSubject of the ticket
tagsobject[]NoTags of the ticket
trashed_datetimestringNoA datetime will move the ticket to the trash, null will move the ticket out of the trash
updated_datetimestringNoWhen the ticket was lastly updated
viastringNoThe via value

gorgias_tickets_update_ticket_custom_field

Update ticket field value Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
idintegerYesThe ID of the custom field.
bodyobjectYesRequest body

gorgias_tickets_update_ticket_custom_fields

Update ticket fields values Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
bodyobject[]YesRequest body

gorgias_tickets_update_ticket_message

Update a message Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket associated with the message.
idintegerYesThe ID of the message to update.
actionstringNoPolicy applied on external actions associated with the message if they failed. Three actions are possible: - force: bypass the failed action and try to execute the remaining one and to send the message - retry: retry the failed action - cancel: delete the TicketMessage
attachmentsobject[]NoA list of files attached to the message.
body_htmlstringNoThe full HTML version of the body of the message, if any.
body_textstringNoThe full text version of the body of the message, if any.
channelstringNoThe channel used to send the message.
external_idstringNoID of the message in a foreign system (Aircall, Zendesk, etc…). This field is not used by Gorgias, feel free to set it as you wish.
failed_datetimestringNoWhen the message failed to be sent. Messages that couldn’t be sent can be resend.
from_agentbooleanNoWhether the message was sent by your company to a customer, or the opposite.
message_idstringNoID of the message on the service that send the message.It can be the ID of an email, a Messenger message, a Facebook comment, etc…
receiverobjectNoThe primary receiver of the message. It can be a user or a customer. Optional when the source type is “internal-note”.
senderobjectNoThe person who sent the message. It can be a user or a customer.
sent_datetimestringNoWhen the message was sent. If ommited, the message will be sent by Gorgias.
sourceobjectNoInformation used to route the message. It contains the names and the addresses of the sender and receivers.
subjectstringNoThe subject of the message.
viastringNoHow the message has been received, or sent from Gorgias.

gorgias_tickets_update_ticket_tags

Set ticket tags Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idintegerYesThe ID of the ticket.
idsinteger[]NoThe IDs of the tags.
namesstring[]NoThe names of the tags.