Zendesk

Helpdesk integration · 24 node(s) including 1 trigger.

00Overview

Manage tickets, users, and organizations in Zendesk Support

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Zendesk

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
API Token	`secret`		Zendesk API token
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Organization

Zendesk: Count Organizations

helpdesk/zendesk/organization_count · Action

Return the number of organizations in your Zendesk account.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token

Returns: count, result, tool_result, success, error

Zendesk: Create Organization

helpdesk/zendesk/organization_create · Action

Create an organization in Zendesk. Set details, notes, domains and tags directly, add custom organization fields as JSON, or use Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Name	`string`	Required	The organization's name
Details	`string`		Details such as the address
Notes	`text`
Domain Names	`string`		acme.com, acme.io (comma-separated)
Tags	`string`		vip, wholesale (comma-separated)
Organization Fields (JSON)	`object`		{"tier":"gold"}
Additional Fields (JSON)	`object`

Returns: id, result, tool_result, success, error

Zendesk: Delete Organization

helpdesk/zendesk/organization_delete · Action

Permanently delete a Zendesk organization by its ID.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Organization ID	`string`	Required	35436

Returns: id, tool_result, success, error

Zendesk: Get Organization

helpdesk/zendesk/organization_get · Action

Retrieve a single Zendesk organization by its ID.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Organization ID	`string`	Required	35436

Returns: id, result, tool_result, success, error

Zendesk: Get Many Organizations

helpdesk/zendesk/organization_get_all · Action

List all organizations in your Zendesk account. Enable Return All to auto-paginate every match.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Return All (auto-paginate every match)	`boolean`
Limit	`integer`		100 per page (max 100)

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Get Organization Related Data

helpdesk/zendesk/organization_get_related_data · Action

Get counts of data related to a Zendesk organization (tickets, users, etc.).

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Organization ID	`string`	Required	35436

Returns: id, result, tool_result, success, error

Zendesk: Update Organization

helpdesk/zendesk/organization_update · Action

Update a Zendesk organization. Change details, notes, domains, tags, custom organization fields, or any other field via Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Organization ID	`string`	Required	35436
Name	`string`		The organization's display name
Details	`string`		Additional details, e.g. account number
Notes	`text`		Freeform notes about the organization
Domain Names	`string`		example.com, example.org (comma-separated)
Tags	`string`		vip, wholesale (comma-separated)
Organization Fields (JSON)	`object`		{"support_plan":"gold"}
Additional Fields (JSON)	`object`		{"group_id":123}

Returns: id, result, tool_result, success, error

03Ticket

Zendesk: Create Ticket

helpdesk/zendesk/ticket_create · Action

Create a support ticket in Zendesk. The Description becomes the ticket's first comment; set common fields directly or add any other ticket field via Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Description	`text`	Required	The ticket's first comment
Subject	`string`
Type	`string`		choices: Question, Incident, Problem, Task
Priority	`string`		choices: Urgent, High, Normal, Low
Status	`string`		choices: New, Open, Pending, On-Hold, Solved, Closed
Recipient	`string`		The original recipient email address of the ticket
Group	`string`	● live picker	The group this ticket is assigned to (ID)
Assignee ID	`string`		Agent user ID to assign the ticket to
Requester ID	`string`		User ID of the ticket requester
External ID	`string`		An ID linking this ticket to a record in another system
Tags	`string`		vip, refund (comma-separated)
Custom Fields (JSON)	`object`		[{"id":123,"value":"blue"}]
Additional Fields (JSON)	`object`		{"collaborator_ids":[1,2]}

Returns: id, result, tool_result, success, error

Zendesk: Delete Ticket

helpdesk/zendesk/ticket_delete · Action

Permanently delete a Zendesk ticket by its ID. Choose Regular for a normal ticket or Suspended for one held in the suspended queue.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Ticket Type	`string`		choices: Regular, Suspended
Ticket ID	`string`	Required	35436

Returns: id, tool_result, success, error

Zendesk: Get Ticket Field

helpdesk/zendesk/ticket_field_get · Action

Retrieve a single Zendesk ticket field (system or custom) by its ID.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Ticket Field ID	`string`	Required	The ticket field ID

Returns: id, result, tool_result, success, error

Zendesk: Get Many Ticket Fields

helpdesk/zendesk/ticket_field_get_all · Action

List all system and custom ticket fields in your Zendesk account. Enable Return All to auto-paginate.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Return All (auto-paginate every match)	`boolean`
Limit	`integer`		100 per page (max 100)

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Get Ticket

helpdesk/zendesk/ticket_get · Action

Retrieve a single Zendesk ticket by its ID. Choose Regular for a normal ticket or Suspended for one held in the suspended queue.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Ticket Type	`string`		choices: Regular, Suspended
Ticket ID	`string`	Required	35436

Returns: id, result, tool_result, success, error

Zendesk: Get Many Tickets

helpdesk/zendesk/ticket_get_all · Action

List Zendesk tickets. Regular tickets are fetched via the Search API (filter by status, group, or a raw query); Suspended lists the suspended queue. Enable Return All to auto-paginate.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Ticket Type	`string`		choices: Regular, Suspended
Return All (auto-paginate every match)	`boolean`
Limit	`integer`		100 per page (max 100); Return All still fetches every match
Query	`string`		Extra Zendesk search terms, e.g. priority:high created>2024-01-01
Status	`string`		choices: New, Open, Pending, On-Hold, Solved, Closed
Group	`string`	● live picker	Restrict to a group (ID)
Sort By	`string`		choices: Created At, Priority, Status, Ticket Type, Updated At
Sort Order	`string`		choices: Ascending, Descending

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Recover Suspended Ticket

helpdesk/zendesk/ticket_recover · Action

Recover a ticket from the suspended queue, turning it into a regular ticket.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Suspended Ticket ID	`string`	Required	35436

Returns: id, result, tool_result, success, error

Zendesk: Update Ticket

helpdesk/zendesk/ticket_update · Action

Update a Zendesk ticket. Add a public reply or an internal note, change status/priority/assignee, and set any other ticket field via Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Ticket ID	`string`	Required	35436
Subject	`string`
Public Reply	`text`		A reply added as a public comment on the ticket
Internal Note	`text`		A private note (accepts HTML) visible only to agents
Type	`string`		choices: Question, Incident, Problem, Task
Priority	`string`		choices: Urgent, High, Normal, Low
Status	`string`		choices: New, Open, Pending, On-Hold, Solved, Closed
Recipient	`string`		The original recipient email address of the ticket
Group	`string`	● live picker	The group this ticket is assigned to (ID)
Assignee ID	`string`		Agent user ID to assign the ticket to
Assignee Email	`string`		Email of the agent to assign the ticket to
External ID	`string`		An ID linking this ticket to a record in another system
Tags	`string`		vip, refund (comma-separated) — replaces the ticket's tags
Custom Fields (JSON)	`object`		[{"id":123,"value":"blue"}]
Additional Fields (JSON)	`object`		{"collaborator_ids":[1,2]}

Returns: id, result, tool_result, success, error

04User

Zendesk: Create User

helpdesk/zendesk/user_create · Action

Create a user in Zendesk. Set common profile fields directly, add custom user fields as JSON, or add any other field via Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Name	`string`	Required	The user's full name
Email	`string`		name@email.com
Role	`string`		choices: End User, Agent, Admin
Phone	`string`
Alias	`string`		An alias displayed to end users
Organization	`string`	● live picker	Default organization (ID)
External ID	`string`		A unique identifier from another system
Details	`string`		Details such as an address
Notes	`text`
Timezone	`string`		e.g. Pacific Time (US & Canada)
Locale	`string`		e.g. en-US
Signature	`string`		Agent/admin signature
Custom Role ID	`integer`
Ticket Restriction	`string`		choices: Organization, Groups, Assigned, Requested
Moderator	`boolean`
Only Private Comments	`boolean`
Restricted Agent	`boolean`
Report CSV	`boolean`
Suspended	`boolean`
Verified	`boolean`
Tags	`string`		vip, priority (comma-separated)
User Fields (JSON)	`object`		{"support_plan":"gold"}
Additional Fields (JSON)	`object`

Returns: id, result, tool_result, success, error

Zendesk: Delete User

helpdesk/zendesk/user_delete · Action

Permanently delete (soft-delete) a Zendesk user by their ID.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
User ID	`string`	Required	35436

Returns: id, tool_result, success, error

Zendesk: Get User

helpdesk/zendesk/user_get · Action

Retrieve a single Zendesk user by their ID.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
User ID	`string`	Required	The user ID

Returns: id, result, tool_result, success, error

Zendesk: Get Many Users

helpdesk/zendesk/user_get_all · Action

List Zendesk users, optionally filtered by role. Enable Return All to auto-paginate every match.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Return All (auto-paginate every match)	`boolean`
Limit	`integer`		100 per page (max 100)
Role	`string`		choices: End User, Agent, Admin

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Get User's Organizations

helpdesk/zendesk/user_get_organizations · Action

List the organizations a Zendesk user belongs to.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
User ID	`string`	Required	35436

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Get User Related Data

helpdesk/zendesk/user_get_related_data · Action

Get counts of data related to a Zendesk user (assigned tickets, requested tickets, organization subscriptions, etc.).

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
User ID	`string`	Required	35436

Returns: id, result, tool_result, success, error

Zendesk: Search Users

helpdesk/zendesk/user_search · Action

Search Zendesk users by name, email, phone, or external ID. Enable Return All to auto-paginate every match.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Return All (auto-paginate every match)	`boolean`
Limit	`integer`		100 per page (max 100)
Query	`string`		Name, email, phone, or a search term
External ID	`string`		Match users by external ID

Returns: results, count, next_page, result, tool_result, success, error

Zendesk: Update User

helpdesk/zendesk/user_update · Action

Update a Zendesk user. Change profile fields, custom user fields, or any other field via Additional Fields.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
User ID	`string`	Required	35436
Name	`string`		The user's full name
Email	`string`		The user's primary email address
Role	`string`		choices: End User, Agent, Admin
Phone	`string`		+1 555 123 4567
Alias	`string`		An agent alias displayed to end users
Organization	`string`	● live picker	The organization this user belongs to (ID)
External ID	`string`		An ID linking this user to a record in another system
Details	`text`		Details about the user, such as an address
Notes	`text`		Notes about the user
Time Zone	`string`		e.g. Pacific Time (US & Canada)
Locale	`string`		e.g. en-US
Signature	`text`		The agent's signature (agents and admins only)
Custom Role ID	`integer`		The ID of a custom agent role
Ticket Restriction	`string`		choices: Organization, Groups, Assigned, Requested
Moderator	`boolean`		Whether the user has forum moderation capabilities
Only Private Comments	`boolean`		Whether the user can only create private comments
Restricted Agent	`boolean`		Whether the agent has restrictions
Report CSV	`boolean`		Whether the user can access the CSV report
Suspended	`boolean`		Whether the user is suspended
Verified	`boolean`		Whether the user's identities are verified
Tags	`string`		vip, wholesale (comma-separated) — replaces the user's tags
User Fields (JSON)	`object`		{"support_plan":"gold"}
Additional Fields (JSON)	`object`		{"shared_phone_number":true}

Returns: id, result, tool_result, success, error

05Triggers

Zendesk Webhook Trigger

trigger/zendesk_webhook · Trigger

Triggers a flow when a Zendesk ticket is created or updated. Flomation registers the Zendesk webhook and business rule automatically. Leave Conditions empty to fire on every ticket create/update, or supply Zendesk trigger conditions as JSON to narrow it.

Field	Type		Details
Subdomain	`string`	Required	mycompany (from mycompany.zendesk.com)
Agent Email	`string`		you@company.com (paired with the API token to register the webhook)
OAuth Access Token	`secret`		Optional — a bearer token used instead of the email + API token
Conditions (JSON)	`object`		Optional — Zendesk trigger conditions, e.g. {"all":[{"field":"priority","operator":"is","value":"high"}]}

Returns: content, ticket_id, subject, status, priority, requester_email, description, via, payload, body, triggered_at

06Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Regular ticket listing and filtering run through Zendesk's Search API, whose index updates a short moment after a change, so a ticket or user you just created or edited may not appear in results immediately.
Search-backed results (regular ticket lists and user search) are capped by Zendesk at 1,000 matches even with Return All enabled, so a very large result set will be truncated.
Deleting a ticket or an organization is permanent, whereas deleting a user is a soft-delete that can still be recovered inside Zendesk afterwards.
Tags are supplied as a single comma-separated list rather than selected individually.
API token access must be switched on in your Zendesk Admin Center (APIs settings) before these nodes can authenticate, and a newly enabled token can take a few minutes to start working.