Skip to main content
Required scopes: support_tickets_read

Arguments

[ID!]
Tickets assigned to any of these team members, at most 100. assigneeIds, assigneeTypes and includeUnassigned match as one OR.
[SupportTicketAssigneeType!]
Tickets with any of these kinds of assignee. Matches with assigneeIds and includeUnassigned as one OR.
[MessageChannel!]
On any of these channels.
DateTime
Only tickets closed after this instant.
DateTime
Only tickets closed before this instant.
DateTime
Only tickets created after this instant.
DateTime
Only tickets created before this instant.
ID
The customer’s id or legacy id. Requires customers_read.Requires: customers_read
[ID!]
Has none of these tags, at most 100.
[String!]
Tickets that came in on any of these store inbox addresses, at most 100. Matched without case.
Boolean
Also match tickets with no assignee. Matches with assigneeIds and assigneeTypes as one OR.
DateTime
Only tickets whose last customer message is after this instant.
DateTime
Only tickets whose last customer message is before this instant.
DateTime
Only tickets whose last message from the team, the AI agent or an automation is after this instant.
DateTime
Only tickets whose last message from the team, the AI agent or an automation is before this instant.
DateTime
Only tickets whose last message, from the customer or the team, is after this instant.
DateTime
Only tickets whose last message, from the customer or the team, is before this instant.
[ID!]
Tickets with an internal note that @mentions any of these team members, at most 100.
String
The inbox search: message and subject words, the customer’s name, email or phone, order numbers. At most 200 characters. Matches customer details with only support_tickets_read, as the inbox does.
[SupportTicketSearchField!]
Where query looks. Omitted or empty: everywhere, including the AI summary.
[String!]
Tickets that contain every one of these keywords, at most 10 of 200 characters each. Searches what query does except order numbers, and matches customer details with only support_tickets_read.
[SupportTicketSearchField!]
Where searchContains looks. Omitted or empty: everywhere it can.
[SupportTicketStatus!]
Any of these. Omitted or empty: every status but ARCHIVED, as the help desk lists tickets; name ARCHIVED to include archived tickets.
[ID!]
Has any of these tags, at most 100.
Boolean
True: tickets with a customer message the team has not read yet. False: the others, including tickets the customer never wrote on.

Returns

Int!
required

Example