Zammad

Help desk: tickets, articles, users, organizations, and groups

Connect Zammad

Field	What to enter
Zammad addressRequired	The host name of your Zammad, for example support.example.com.Example: `support.example.com`
API tokenRequiredSecret	A Zammad access token (Profile > Token Access) with the permissions the flow needs, such as ticket.agent.
Cloudflare Access client idOptionalSecret	Only for a Zammad behind Cloudflare Access: the service token's client id.
Cloudflare Access client secretOptionalSecret	Only for a Zammad behind Cloudflare Access: the service token's client secret.

For events that arrive as a webhook, add a Webhook trigger and enter its Webhook URL in Zammad's webhook settings.

Event	What it does	How
Trigger webhook	Fires when a Zammad trigger with a webhook action posts its ticket (and article).	Receives a webhook

62 operations in 12 groups. Each one is a step you can add to a flow.

Article4

Add an article`createTicketArticle`	POST	Add a message, reply or note to a ticket.
Download an attachment`downloadTicketAttachment`	GET	The file of one article attachment.
Get an article`getTicketArticle`	GET	Fetch one article by its id.
List a ticket's articles`listTicketArticles`	GET	Every article (message, note, reply) of a ticket.

Group6

Create a group`createGroup`	POST	Create a group.
Delete a group`deleteGroup`	DELETE	Delete a group; Zammad refuses while other records refer to it.
Get a group`getGroup`	GET	Fetch one group by its id.
List groups`listGroups`	GET	Every group.
Search groups`searchGroups`	GET	Search groups with Zammad's query syntax.
Update a group`updateGroup`	PUT	Change a group's fields.

Link3

Link two tickets`addTicketLink`	POST	Link a ticket (by number) to another ticket (by id).
List a ticket's links`listTicketLinks`	GET	The tickets linked to one ticket.
Unlink two tickets`removeTicketLink`	DELETE	Remove the link between two tickets.

Organization6

Create a organization`createOrganization`	POST	Create a organization.
Delete a organization`deleteOrganization`	DELETE	Delete a organization; Zammad refuses while other records refer to it.
Get a organization`getOrganization`	GET	Fetch one organization by its id.
List organizations`listOrganizations`	GET	Every organization.
Search organizations`searchOrganizations`	GET	Search organizations with Zammad's query syntax.
Update a organization`updateOrganization`	PUT	Change a organization's fields.

Role5

Create a role`createRole`	POST	Create a role.
Get a role`getRole`	GET	Fetch one role by its id.
List roles`listRoles`	GET	Every role.
Search roles`searchRoles`	GET	Search roles with Zammad's query syntax.
Update a role`updateRole`	PUT	Change a role's fields.

Search1

Search everythingsearch GET Zammad's global search over tickets, users and organizations.

Tag7

Create a tag`createTag`	POST	Add a tag to the tag list (admin permission).
Delete a tag`deleteTag`	DELETE	Remove a tag from the tag list and from every ticket (admin permission).
List a ticket's tags`listTicketTags`	GET	The tags on one ticket.
List all tags`listTags`	GET	Every tag with its id and how often it is used (admin permission).
Remove a ticket tag`removeTicketTag`	DELETE	Remove a tag from a ticket.
Rename a tag`renameTag`	PUT	Rename a tag everywhere it is used (admin permission).
Tag a ticket`addTicketTag`	POST	Add a tag to a ticket; an unknown tag is created when the instance allows it.

Ticket6

Create a ticket`createTicket`	POST	Create a ticket, optionally with its first article.
Delete a ticket`deleteTicket`	DELETE	Permanently delete a ticket with its articles (admin permission).
Get a ticket`getTicket`	GET	Fetch one ticket by its id.
List tickets`listTickets`	GET	Page through the tickets the token's user can see.
Search tickets`searchTickets`	GET	Search tickets with Zammad's query syntax (for example tags:development AND state.name:open).
Update a ticket`updateTicket`	PUT	Change a ticket's fields, optionally adding an article in the same call.

Ticket priority5

Create a ticket priority`createTicketPriority`	POST	Create a ticket priority.
Delete a ticket priority`deleteTicketPriority`	DELETE	Delete a ticket priority; Zammad refuses while other records refer to it.
Get a ticket priority`getTicketPriority`	GET	Fetch one ticket priority by its id.
List ticket prioritys`listTicketPrioritys`	GET	Every ticket priority.
Update a ticket priority`updateTicketPriority`	PUT	Change a ticket priority's fields.

Ticket state5

Create a ticket state`createTicketState`	POST	Create a ticket state.
Delete a ticket state`deleteTicketState`	DELETE	Delete a ticket state; Zammad refuses while other records refer to it.
Get a ticket state`getTicketState`	GET	Fetch one ticket state by its id.
List ticket states`listTicketStates`	GET	Every ticket state.
Update a ticket state`updateTicketState`	PUT	Change a ticket state's fields.

Time accounting5

Account time`createTicketTimeAccounting`	POST	Record time spent on a ticket.
Delete a time entry`deleteTicketTimeAccounting`	DELETE	Remove a time entry (admin time-accounting permission).
Get a time entry`getTicketTimeAccounting`	GET	One time entry of a ticket.
List time entries`listTicketTimeAccountings`	GET	The time accounted on one ticket.
Update a time entry`updateTicketTimeAccounting`	PUT	Change a time entry (admin time-accounting permission).

User9

Create a user`createUser`	POST	Create a user.
Delete a user`deleteUser`	DELETE	Delete a user; Zammad refuses while other records refer to it.
Delete a user (data privacy)`createDataPrivacyTask`	POST	Delete a user and the tickets they are the customer of through Zammad's data-privacy task, the recommended way to remove a user.
Get a data-privacy task`getDataPrivacyTask`	GET	The progress of a data-privacy deletion.
Get a user`getUser`	GET	Fetch one user by its id.
Get the current user`getCurrentUser`	GET	The user the API token belongs to.
List users`listUsers`	GET	Every user.
Search users`searchUsers`	GET	Search users with Zammad's query syntax.
Update a user`updateUser`	PUT	Change a user's fields.