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

Tools

ToolDescription
gorgias_admin_bulk_archive_macrosArchive macros
gorgias_admin_bulk_unarchive_macrosUnarchive macros
gorgias_admin_cancel_jobCancel a job
gorgias_admin_create_account_settingCreate a setting
gorgias_admin_create_integrationCreate an integration
gorgias_admin_create_jobCreate a job
gorgias_admin_create_macroCreate a macro
gorgias_admin_create_ruleCreate a rule
gorgias_admin_create_teamCreate a team
gorgias_admin_create_userCreate a user
gorgias_admin_create_viewCreate a view
gorgias_admin_create_widgetCreate a widget
gorgias_admin_delete_integrationDelete an integration
gorgias_admin_delete_macroDelete a macro
gorgias_admin_delete_ruleDelete a rule
gorgias_admin_delete_teamDelete a team
gorgias_admin_delete_userDelete a user
gorgias_admin_delete_viewDelete a view
gorgias_admin_delete_widgetDelete a widget
gorgias_admin_get_accountRetrieve your account
gorgias_admin_get_integrationRetrieve an integration
gorgias_admin_get_jobRetrieve a job
gorgias_admin_get_macroRetrieve a macro
gorgias_admin_get_ruleRetrieve a rule
gorgias_admin_get_teamRetrieve a team
gorgias_admin_get_userRetrieve a user
gorgias_admin_get_viewRetrieve a view
gorgias_admin_get_widgetRetrieve a widget
gorgias_admin_list_account_settingsList settings
gorgias_admin_list_integrationsList integrations
gorgias_admin_list_jobsList jobs
gorgias_admin_list_macrosList macros
gorgias_admin_list_rulesList rules
gorgias_admin_list_teamsList teams
gorgias_admin_list_usersList users
gorgias_admin_list_view_itemsList view’s items
gorgias_admin_list_viewsList views
gorgias_admin_list_widgetsList widgets
gorgias_admin_update_account_settingUpdate a setting
gorgias_admin_update_integrationUpdate an integration
gorgias_admin_update_jobUpdate a job
gorgias_admin_update_macroUpdate a macro
gorgias_admin_update_ruleUpdate a rule
gorgias_admin_update_rules_prioritiesUpdate rules’ priorities
gorgias_admin_update_teamUpdate a team
gorgias_admin_update_userUpdate a user
gorgias_admin_update_viewUpdate a view
gorgias_admin_update_view_itemsSearch for view’s items
gorgias_admin_update_widgetUpdate a widget

gorgias_admin_bulk_archive_macros

Archive macros Parameters:
ParameterTypeRequiredDefaultDescription
idsinteger[]YesList of macro ids to be archived

gorgias_admin_bulk_unarchive_macros

Unarchive macros Parameters:
ParameterTypeRequiredDefaultDescription
idsinteger[]YesList of macro ids to be unarchived

gorgias_admin_cancel_job

Cancel a job Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the job to cancel.

gorgias_admin_create_account_setting

Create a setting Parameters:
ParameterTypeRequiredDefaultDescription
dataobjectNoThe data value
typestringYesThe type value

gorgias_admin_create_integration

Create an integration Parameters:
ParameterTypeRequiredDefaultDescription
deactivated_datetimestringNoWhen the integration was deactivated.
descriptionstringNoDescription about the integration.
httpobjectNoOnly available for HTTP integrations, defines the configuration of the integration.
managedbooleanNoWhether integration is managed by Gorgias.
namestringYesName of the integration. Usually the email address, Facebook page name, etc.
typestringYesType of integration.

gorgias_admin_create_job

Create a job Parameters:
ParameterTypeRequiredDefaultDescription
metaobjectNoMetadata associated with the job. You can use this parameter to store structured information (key-value data) about the job. This field is not used by Gorgias.
paramsobjectYesThe parameters of the job.
scheduled_datetimestringNoWhen the job was scheduled to be started. A job cannot be scheduled more than 60 minutes in the future. If unspecified, the job is queued for execution immediately after creation.
typestringYesThe type of the job. Options: applyMacro, deleteTicket, exportTicket, importMacro, exportMacro, updateTicket, exportTicketDrilldown, exportConvertCampaignSalesDrilldown

gorgias_admin_create_macro

Create a macro Parameters:
ParameterTypeRequiredDefaultDescription
actionsobject[]NoA list of actions to be applied on tickets.
external_idstringNoExternal ID of the macro in a foreign system. This field is not used by Gorgias, feel free to set it to your own value.
intentstringNoThe intention of the macro should be used for.
languagestringNoThe language of the macro in ISO 639-1 format.
namestringYesThe name of the Macro. Tips: choose a name that can be easily searched.

gorgias_admin_create_rule

Create a rule Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesThe logic of the rule (as JavaScript code).
code_astobjectNoThe logic of the rule (as an ESTree AST representation). Generated from the code if not specified.
deactivated_datetimestringNoWhen the rule was deactivated.
descriptionstringNoThe description of the rule.
event_typesstringNoA list of comma separated events that this rule will be executed on. Valid values: ticket-created, ticket-updated, ticket-message-created, ticket-assigned, ticket-self-unsnoozed, satisfaction-survey-responded.
namestringYesThe name of the rule.
priorityintegerNoOrder of execution of the rule. Rules with higher priorities are executed first.

gorgias_admin_create_team

Create a team Parameters:
ParameterTypeRequiredDefaultDescription
decorationobjectNoObject describing how the team appears on the webpage. Currently only supports emoji field that shows before the team’s name.
descriptionstringNoLonger description of the team.
membersobject[]NoThe list of users within the team.
namestringYesName of the team.

gorgias_admin_create_user

Create a user Parameters:
ParameterTypeRequiredDefaultDescription
biostringNoShort biography of the user.
countrystringNoCountry of the user
emailstringYesEmail address of the user. password_confirmation field must be provided to change the email.
external_idstringNoID of the user in a foreign system (Stripe, Aircall, etc…). This field is not used by Gorgias, feel free to set it as you wish.
languagestringNoThe language value
metaobjectNoData associated with the user. You can use this field to store structured information (key-value data) about the user.
namestringYesFull name of the user.
roleobjectYesThe role of the user.
timezonestringNoTimezone identifier

gorgias_admin_create_view

Create a view Parameters:
ParameterTypeRequiredDefaultDescription
deactivated_datetimestringNoWhen the view was deactivated.
decorationobjectNoObject describing how the view appears in our applications. Currently only supports emoji field that shows before the view’s name.
fieldsstring[]NoList of object’s attributes to be displayed in the UI of our applications.
filtersstringNoThe logic used to filter the items to be displayed in the view (as JavaScript code).
namestringYesThe name of the view.
order_bystringNoName of the object’s attribute used to sort the items of the view.
order_dirstringNoSort direction of the items displayed in the view. Options: asc or desc.
shared_with_teamsinteger[]NoShared With Teams
shared_with_usersinteger[]NoShared With Users
slugstringNoDEPRECATED - URL-compatible name of the view.
typestringNoType of objects the view is applied on.
visibilitystringNoVisibility of the view. Possible values are: - public: any user of your helpdesk can see it. - shared: users listed under shared_with_users attribute and teams listed under shared_with_teams attribute can see it. All admins and lead agents will see it as well, even if they are not explicitly listed in the shared_with_users attribute. - private: only the single user listed under shared_with_users attribute can see it.

gorgias_admin_create_widget

Create a widget Parameters:
ParameterTypeRequiredDefaultDescription
app_idstringNoThe ID of the 3rd party app that the widget’s data is attached to. Used for customer external data widgets.
contextstringNoThe context to display this widget in. Supported values are: ticket, customer, user. The value <span style={{color: ‘red’}}>user has been deprecated</span>, please use customer instead.
deactivated_datetimestringNoWhen the widget was deactivated.
integration_idintegerNoID of the integration that the widget’s data is attached to. Only used for widgets attached to HTTP integrations. Widgets are the same for all Shopify integrations, but each HTTP integration needs a specific widget.
orderintegerNoOrder of precedence of the widget. Widgets with lower order are shown first.
templateobjectYesTemplate to render the data of the widget.
typestringYesType of data the widget is attached to.

gorgias_admin_delete_integration

Delete an integration Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the integration to delete.

gorgias_admin_delete_macro

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

gorgias_admin_delete_rule

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

gorgias_admin_delete_team

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

gorgias_admin_delete_user

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

gorgias_admin_delete_view

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

gorgias_admin_delete_widget

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

gorgias_admin_get_account

Retrieve your account

gorgias_admin_get_integration

Retrieve an integration Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the integration to retrieve.

gorgias_admin_get_job

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

gorgias_admin_get_macro

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

gorgias_admin_get_rule

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

gorgias_admin_get_team

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

gorgias_admin_get_user

Retrieve a user Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the user to retrieve. Use the ID 0 to fetch your user (current user).

gorgias_admin_get_view

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

gorgias_admin_get_widget

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

gorgias_admin_list_account_settings

List settings Parameters:
ParameterTypeRequiredDefaultDescription
typestringNoThe type value

gorgias_admin_list_integrations

List integrations Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all integrations. If omitted, the first integrations of the list will be returned.
limitintegerNoMaximum number of integrations to return.
order_bystringNoAttribute used to order integrations.
typestringNoType of integration.

gorgias_admin_list_jobs

List jobs Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all jobs. If omitted, the first jobs of the list will be returned.
limitintegerNoMaximum number of jobs to return.
order_bystringNoAttribute used to order jobs.
statusstringNoFilter jobs by status.
typestringNoFilter jobs by job type.

gorgias_admin_list_macros

List macros Parameters:
ParameterTypeRequiredDefaultDescription
tagsstring[]NoThe tags value
languagesstring[]NoThe languages value
cursorstringNoValue indicating your position in the list of all tags. If omitted, the first tags of the list will be returned.
limitintegerNoMaximum number of tags to return.
message_idintegerNoOrder macros by the most relevant ones to reply to the given message. When specified, order_by must be set to relevance and ticket_id is required.
order_bystringNoOrder macros by the given attribute. If relevance is specified, ticket_id parameter is required and macros will be ordered by the most relevant macros to reply to the given ticket. In this case, order_dir parameter will be ignored.<br>Values <span style={{color: ‘red’}}>name, created_datetime, update_datetime, usage, relevance have been deprecated</span>. Use values with :asc or :desc instead.
searchstringNoFilter macros containing the given search query.
ticket_idintegerNoOrder macros by the most relevant ones to reply to the given ticket. When specified, order_by must be set to relevance.
number_predictionsintegerNoNumber of relevant macros to return on top of the list.
archivedbooleanNoFilter macros that are archived. If True, only archived macros will be returned.

gorgias_admin_list_rules

List rules Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all rules. If omitted, the first rules of the list will be returned.
limitintegerNoMaximum number of rules to return.
order_bystringNoAttribute used to order rules.

gorgias_admin_list_teams

List teams Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all teams. If omitted, the first team of the list will be returned.
limitintegerNoMaximum number of teams to return.
order_bystringNoAttribute used to order teams.

gorgias_admin_list_users

List users Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all items. If omitted, the first items of the list will be returned.
external_idstringNoID of the user in a foreign system (Stripe, Aircall, etc…) you’re looking for
emailstringNoEmail of the user you’re looking for
limitintegerNoMaximum number of items to return.
order_bystringNoAttribute used to order users.
rolesstring[]NoA list of roles to filter users.
searchstringNoRetrieve users where either the name or email address matches the specified search term.
available_firstbooleanNoWhen true, available users are returned first, followed by non-available users.

gorgias_admin_list_view_items

List view’s items Parameters:
ParameterTypeRequiredDefaultDescription
view_idintegerYesThe ID of the view to list items from.
cursorstringNoValue indicating your position in the list of all the view’s items. If omitted, the first items of the list will be returned.
directionstringNo- prev returns items before the cursor. - next returns items after the cursor.
ignored_itemintegerNoID of an item to ignore in the list of returned items.
limitintegerNoMaximum number of items to return.
order_bystringNoAttribute used to order views.

gorgias_admin_list_views

List views Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all views. If omitted, the first views of the list will be returned.
limitintegerNoMaximum number of views to return.
order_bystringNoAttribute used to order views.

gorgias_admin_list_widgets

List widgets Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoValue indicating your position in the list of all widgets. If omitted, the first widgets of the list will be returned.
limitintegerNoMaximum number of widgets to return.
order_bystringNoAttribute used to order widgets.
integration_idintegerNoThe ID of the integration to filter the widgets list by.
app_idstringNoThe ID of the 3rd party app to filter the widgets list by.

gorgias_admin_update_account_setting

Update a setting Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the setting to update.
dataobjectNoThe data value
typestringNoThe type value

gorgias_admin_update_integration

Update an integration Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the integration to update.
deactivated_datetimestringNoWhen the integration was deactivated.
descriptionstringNoDescription about the integration.
httpobjectNoOnly available for HTTP integrations, defines the configuration of the integration.
namestringNoName of the integration. Usually the email address, Facebook page name, etc.

gorgias_admin_update_job

Update a job Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the job to update.
metaobjectNoMetadata associated with the job. You can use this parameter to store structured information (key-value data) about the job. This field is not used by Gorgias.
paramsobjectNoThe parameters of the job.
scheduled_datetimestringNoWhen the job was scheduled to be started. A job cannot be scheduled more than 60 minutes in the future. If unspecified, the job is queued for execution immediately after creation.
statusstringNoThe status of the job. Options: cancel_requested, canceled, done, errored, fatal_errored, pending, running, scheduled

gorgias_admin_update_macro

Update a macro Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the macro to update.
actionsobject[]NoA list of actions to be applied on tickets.
external_idstringNoExternal ID of the macro in a foreign system. This field is not used by Gorgias, feel free to set it to your own value.
intentstringNoThe intention of the macro should be used for.
languagestringNoThe language of the macro in ISO 639-1 format.
namestringNoThe name of the Macro. Tips: choose a name that can be easily searched.

gorgias_admin_update_rule

Update a rule Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the rule to update.
codestringNoThe logic of the rule (as JavaScript code).
code_astobjectNoThe logic of the rule (as an ESTree AST representation). Generated from the code if not specified.
deactivated_datetimestringNoWhen the rule was deactivated.
descriptionstringNoThe description of the rule.
event_typesstringNoA list of comma separated events that this rule will be executed on. Valid values: ticket-created, ticket-updated, ticket-message-created, ticket-assigned, ticket-self-unsnoozed, satisfaction-survey-responded.
namestringNoThe name of the rule.
priorityintegerNoOrder of execution of the rule. Rules with higher priorities are executed first.

gorgias_admin_update_rules_priorities

Update rules’ priorities Parameters:
ParameterTypeRequiredDefaultDescription
prioritiesobject[]YesA list of rule IDs with their new priorities.

gorgias_admin_update_team

Update a team Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the team to update.
decorationobjectNoObject describing how the team appears on the webpage. Currently only supports emoji field that shows before the team’s name.
descriptionstringNoLonger description of the team.
membersobject[]NoThe list of users within the team.
namestringNoName of the team.

gorgias_admin_update_user

Update a user Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the user to update. Use the ID 0 to update your user (current user).
biostringNoShort biography of the user.
countrystringNoCountry of the user
emailstringNoEmail address of the user. password_confirmation field must be provided to change the email.
external_idstringNoID of the user in a foreign system (Stripe, Aircall, etc…). This field is not used by Gorgias, feel free to set it as you wish.
languagestringNoLanguage of the user.
metaobjectNoData associated with the user. You can use this field to store structured information (key-value data) about the user.
namestringNoFull name of the user.
new_passwordstringNoNew password of the user. old_password field must be provided when changing the password.
old_passwordstringNoCurrent password of the user.
password_confirmationstringNoCurrent password of the user.
roleobjectNoThe role of the user.
timezonestringNoTimezone of the user.
two_fa_codestringNoTwo Fa Code

gorgias_admin_update_view

Update a view Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the view to update.
deactivated_datetimestringNoWhen the view was deactivated.
decorationobjectNoObject describing how the view appears in our applications. Currently only supports emoji field that shows before the view’s name.
fieldsstring[]NoList of object’s attributes to be displayed in the UI of our applications.
filtersstringNoThe logic used to filter the items to be displayed in the view (as JavaScript code).
namestringNoThe name of the view.
order_bystringNoName of the object’s attribute used to sort the items of the view.
order_dirstringNoSort direction of the items displayed in the view. Options: asc or desc.
shared_with_teamsinteger[]NoShared With Teams
shared_with_usersinteger[]NoShared With Users
slugstringNoDEPRECATED - URL-compatible name of the view.
typestringNoType of objects the view is applied on.
visibilitystringNoVisibility of the view. Possible values are: - public: any user of your helpdesk can see it. - shared: users listed under shared_with_users attribute and teams listed under shared_with_teams attribute can see it. All admins and lead agents will see it as well, even if they are not explicitly listed in the shared_with_users attribute. - private: only the single user listed under shared_with_users attribute can see it.

gorgias_admin_update_view_items

Search for view’s items Parameters:
ParameterTypeRequiredDefaultDescription
view_idintegerYesThis parameter should be set to 0.
cursorstringNoValue indicating your position in the list of all the view’s items. If omitted, the first items of the list will be returned.
directionstringNo- prev returns items before the cursor. - next returns items after the cursor.
ignored_itemintegerNoID of an item to ignore in the list of returned items.
limitintegerNoMaximum number of items to return.
order_bystringNoAttribute used to order views.
viewobjectNoThe view value

gorgias_admin_update_widget

Update a widget Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe ID of the widget to update.
app_idstringNoThe ID of the 3rd party app that the widget’s data is attached to. Used for customer external data widgets.
contextstringNoThe context to display this widget in. Supported values are: ticket, customer, user. The value <span style={{color: ‘red’}}>user has been deprecated</span>, please use customer instead.
deactivated_datetimestringNoWhen the widget was deactivated.
integration_idintegerNoID of the integration that the widget’s data is attached to. Only used for widgets attached to HTTP integrations. Widgets are the same for all Shopify integrations, but each HTTP integration needs a specific widget.
orderintegerNoOrder of precedence of the widget. Widgets with lower order are shown first.
templateobjectNoTemplate to render the data of the widget.
typestringNoType of data the widget is attached to.