Skip to main content

Zendesk Component

Manage tickets and users in Zendesk.

Component key: zendesk ·
· Changelog ↓

Description

Zendesk is a public company headquartered in San Francisco, California. It provides software-as-a-service products related to customer support, sales, and other customer communications. The Zendesk component allows managing Users and Tickets inside a Zendesk domain.

Zendesk webhooks

The Zendesk API supports two types of webhooks - one for when something has changed for a user or an organization, and one when something has changed on a support ticket.

Zendesk user and support webhooks

To be alerted when a change to a user or organization has occurred, create a new webhook using the Create Webhook action. Select the events that will cause the webhook to fire. For example, selecting the zen:event-type:user.deleted event will cause the webhook to fire whenever a user is deleted. A full list of webhook event types are available in the Zendesk developer docs.

Zendesk ticket webhooks

To be alerted when a ticket has changed, first create a webhook using the Create Webhook action. When selecting webhook events, choose conditional_ticket_events (and only that value). This will create a webhook, pointed at an integration flow, that can be triggered conditionally.

Next, a trigger must be created that will send data via the webhook just created. Fetch the webhook's id from the step where the webhook was created, and feed it into a Create Trigger action. The default conditional and webhook body values will cause the webhook to be triggered whenever a ticket is changed, and will send all data related to the ticket to the webhook. Keeping the default values is recommended. The conditions under which the trigger fires can be changed - see the Zendesk conditions reference for details.

Connections

API Token

key: apiToken

To use the API Token connection for Zendesk, provide the following parameters:

  • For Username enter the email of the Zendesk account.
  • For API Token enter the generated API Token under Admin Center (https://YOUR-DOMAIN-HERE.zendesk.com/admin/home) -> App and Registrations -> Zendesk API -> Token access.
  • For Zendesk Domain enter the Zendesk Subdomain. The subdomain can be found inside of the Zendesk URL: https://YOUR-DOMAIN-HERE.zendesk.com/
InputNotesExample
API Token

Your generated API token from Zendesk.

your-api-token
Zendesk Domainhttps://{{#zendeskDomain}}.zendesk.com
Username

Your Zendesk username. (Email address used to login to Zendesk).

john.doe@example.com
Zendesk Sub Domain

Your Zendesk sub domain. (e.g. if your Zendesk URL is https://acme-inc.zendesk.com, then your sub domain is acme-inc).

acme-inc

OAuth 2.0 (Deprecated)

key: oauth2

The Zendesk component authenticates requests with OAuth 2.0. This connection (OAuth 2.0 (Deprecated)) is retained for backward compatibility; new connections should use OAuth 2.0 (oauth2DynamicInputs). To configure an application inside Zendesk follow the directions in this guide. Then, create a new Zendesk connection.

  • For Client ID enter the unique identifier of the app inside the Zendesk admin dashboard.
  • For Client Secret enter the generated client secret received from the Zendesk admin dashboard.
  • For Scopes refer to the guide linked above. It contains detailed information on picking the correct scope.

The subdomain can be found inside of the Zendesk URL: https://YOUR-DOMAIN-HERE.zendesk.com/

InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Zendesk.

https://acme-inc.zendesk.com/oauth/authorizations/new
Client ID
Client Secret
Scopes

A space-delimited set of one or more scopes to get the user's permission to access.

read write
Token URL

The OAuth 2.0 Token URL for Zendesk.

https://acme-inc.zendesk.com/oauth/tokens

OAuth 2.0

key: oauth2DynamicInputs

The Zendesk component authenticates requests with OAuth 2.0. To configure an application inside Zendesk follow the directions in this guide. Then, create a new Zendesk connection.

  • For Zendesk Sub Domain enter the Zendesk sub domain (e.g. if the Zendesk URL is https://acme-inc.zendesk.com, then the sub domain is acme-inc).
  • For Client ID enter the unique identifier of the app inside the Zendesk admin dashboard.
  • For Client Secret enter the generated client secret received from the Zendesk admin dashboard.
  • For Scopes refer to the guide linked above. It contains detailed information on picking the correct scope.
InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Zendesk.

https://{{#domain}}.zendesk.com/oauth/authorizations/new
Client ID
Client Secret
Zendesk Sub Domain

Your Zendesk sub domain. (e.g. if your Zendesk URL is https://acme-inc.zendesk.com, then your sub domain is acme-inc).

acme-inc
Scopesread write
Token URL

The OAuth 2.0 Token URL for Zendesk.

https://{{#domain}}.zendesk.com/oauth/tokens

Triggers

New and Updated Tickets

Checks for new and updated tickets in Zendesk on a configured schedule. | key: pollChangesTrigger

InputNotesExample
Connection

The Zendesk connection to use.

Show New Records

When true, newly created tickets are included in the trigger output.

true
Show Updated Records

When true, tickets updated since the last poll are included in the trigger output.

true

The New and Updated Tickets polling trigger checks Zendesk on a configured schedule for tickets that were created or modified since the last poll. Unlike webhook-based triggers, polling does not require webhook subscription management and works reliably for low-frequency monitoring scenarios.

The trigger uses Zendesk's Incremental Tickets Export endpoint with cursor-based pagination. This guarantees that no tickets are missed between runs and avoids re-processing old data, because Zendesk returns a stable cursor that points to the exact position in the ticket change stream.

How It Works

On each scheduled execution, the trigger:

  1. Reads lastPolledAt and afterCursor from the polling state. On the first run, start_time is set to 60 seconds before the current time, because Zendesk requires start_time to be at least one minute in the past.
  2. Calls the Zendesk Incremental Tickets Export endpoint, resuming from the persisted afterCursor when available, or using start_time on the first run. The trigger drains all pages until end_of_stream is reached.
  3. Partitions the collected tickets into created and updated buckets by comparing each ticket's created_at against the lastPolledAt cutoff. Tickets whose created_at is after the cutoff land in created, all others land in updated.
  4. Persists both the new afterCursor and the current execution time as lastPolledAt for the next run.
  5. Emits the partitioned results filtered by the Show New Records and Show Updated Records toggles.

Returned Data

The trigger emits a payload with two arrays, created and updated, each containing ticket resources from the Zendesk Incremental Tickets Export endpoint.

Example Payload
{
"data": {
"created": [
{
"id": 35437,
"subject": "New ticket received",
"status": "new",
"priority": "normal",
"created_at": "2026-05-20T14:00:00Z",
"updated_at": "2026-05-20T14:00:00Z",
"requester_id": 114092137191
}
],
"updated": [
{
"id": 35436,
"subject": "Re: Billing question",
"status": "open",
"priority": "high",
"created_at": "2009-07-20T22:55:29Z",
"updated_at": "2026-05-20T15:00:00Z",
"requester_id": 114092137191
}
]
}
}

Fields shown are representative. The full response object includes additional properties.

Example Payload for New and Updated Tickets
Loading…

Webhook

Receive and validate webhook requests from Zendesk for manually configured webhook subscriptions. | key: webhook

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Webhook
Loading…

Data Sources

Select Article Subscription

Select a subscription for an article in the Zendesk Help Center. | key: selectArticleSubscription | type: picklist

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Connection

The Zendesk connection to use.


Select Articles

Select an article from a dropdown menu. | key: listArticlesDataSource | type: picklist

InputNotesExample
Locale

The locale code for the resource.

en-us
Connection

The Zendesk connection to use.


Select Categories

Select a category from a dropdown menu. | key: listCategoriesDataSource | type: picklist

InputNotesExample
Locale

The locale code for the resource.

en-us
Connection

The Zendesk connection to use.


Select Management Permission Groups

Select a management permission group from a dropdown menu. | key: listPermissionGroupsDataSource | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.


Select Post

Select a post from the Zendesk Help Center. | key: selectPost | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Select Post
Loading…

Select Post Subscription

Select a subscription for a post in the Zendesk Help Center. | key: selectPostSubscription | type: picklist

InputNotesExample
Post ID

The unique identifier for the post.

12
Connection

The Zendesk connection to use.


Select Section Subscription

Select a subscription for a section in the Zendesk Help Center. | key: selectSectionSubscription | type: picklist

InputNotesExample
Section ID

The unique identifier for the section.

123123213
Connection

The Zendesk connection to use.


Select Sections

Select a section from a dropdown menu. | key: listSectionsDataSource | type: picklist

InputNotesExample
Locale

The locale code for the resource.

en-us
Connection

The Zendesk connection to use.


Select Tags

Select a tag from a dropdown menu. | key: listTagsDataSource | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.


Select Ticket

Select a ticket from your Zendesk account. | key: selectTicket | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Select Ticket
Loading…

Select Topic

Select a topic from the Zendesk Help Center. | key: selectTopic | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Select Topic
Loading…

Select Topic Subscription

Select a subscription for a topic in the Zendesk Help Center. | key: selectTopicSubscription | type: picklist

InputNotesExample
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.


Select User

Select a user from your Zendesk account. | key: selectUser | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Select User
Loading…

Select User Segments

Select a user segment from a dropdown menu. | key: listUserSegmentsDataSource | type: picklist

InputNotesExample
Connection

The Zendesk connection to use.


Actions

Associate Attachments to Article

Associate attachments in bulk to a single article, with a maximum of 20 attachments per request. | key: associateAttachmentsInBulkToArticle

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Attachment IDs

The list of attachment IDs to attach to the object.

Locale

The locale code for the resource.

en-us
Connection

The Zendesk connection to use.

Example Payload for Associate Attachments to Article
Loading…

Create Article

Create a new article in the Help Center. | key: createArticle

InputNotesExample
Body

The main content of the article.

Example Body
Title

The headline displayed for the article.

Example Title
Draft

When true, the article is saved as a draft instead of published.

false
Locale

The locale code for the resource.

en-us
Notify Subscribers

When false, suppresses the article creation email to subscribers. Useful when creating many articles at once.

false
Permission Group ID

The unique identifier for the permission group.

15
Section ID

The unique identifier for the section.

123123213
User Segment ID

The unique identifier for the user segment.

15
Connection

The Zendesk connection to use.

Example Payload for Create Article
Loading…

Create Article Attachment

Create an attachment for an article in the Help Center. | key: createArticleAttachment

InputNotesExample
Article ID

The unique identifier for the article.

123123213
File

The File Attachment to upload.

File Name

The display name to use for the uploaded file.

file.jpg
Inline

When true, the attachment is rendered inline within the content.

false
Connection

The Zendesk connection to use.

Example Payload for Create Article Attachment
Loading…

Create Article Subscription

Create a subscription to an article in the Help Center. | key: createArticleSubscription

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Locale

The locale of the article. If not provided, the default locale is used.

User ID

The ID of the user to subscribe to the section. If none provided, the API assumes the current user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Create Article Subscription
Loading…

Create Category

Create a category in the Help Center. | key: createCategory

InputNotesExample
Category Description

The descriptive text shown below the category title.

Example Description
Category Name

The display name of the category.

Example Category
Locale

The locale code for the resource.

en-us
Position

The position of the category to be created.

42
Connection

The Zendesk connection to use.

Example Payload for Create Category
Loading…

Create Post

Create a new post in the Help Center. | key: createPost

InputNotesExample
Content Tag IDs

The list of content tag IDs to attach to the object.

Featured

When true, the post is featured prominently in the community.

false
Pinned

When true, the post is pinned to the top of its topic.

false
Notify Subscribers

When false, suppresses the article creation email to subscribers. Useful when creating many articles at once.

false
Details

The main body content of the post.

Status

The current workflow state of the post.

Title

The headline displayed for the post.

Example Title
Topic ID

The ID of the topic to create the post in.

12
Connection

The Zendesk connection to use.

Example Payload for Create Post
Loading…

Create Post Subscription

Create a post subscription in the Help Center. | key: createPostSubscription

InputNotesExample
Post ID

The unique identifier for the post.

12
User ID

The ID of the user to subscribe to the post. If none provided, the API assumes the current user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Create Post Subscription
Loading…

Create Section

Create a section in the Help Center. | key: createSection

InputNotesExample
Category ID

The unique identifier for the category.

12
Locale

The locale code for the resource.

en-us
Position

The position of the section.

42
Section Description

The descriptive text shown below the section title.

Example Description
Section Name

The display name of the section.

Example Section
Connection

The Zendesk connection to use.

Example Payload for Create Section
Loading…

Create Section Subscription

Create a section subscription in the Help Center. | key: createSectionSubscription

InputNotesExample
Include Comments

When true, the subscription also includes notifications for comments.

false
Locale

The locale of the section. If not provided, the default locale is used.

Section ID

The unique identifier for the section.

123123213
User ID

The ID of the user to subscribe to the section. If none provided, the API assumes the current user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Create Section Subscription
Loading…

Create Ticket

Create a new ticket. | key: createTicket

InputNotesExample
Assignee ID

The unique identifier for the user assigned to the ticket.

403598029853443232
External ID

The ID of this issue from an external system

Followers

The list of user IDs to add as followers on the issue.

488042375842
Recipient Email

The email address of the ticket recipient.

Jane.Doe@example.com
Requester Email

The email address of the person requesting the ticket.

John.Doe@example-email.com
Requester Name

The full name of the person requesting the ticket.

John Doe
Requester Organization ID

The unique identifier for the organization the requester belongs to.

488042375842
Tags

The list of tags to attach to the resource.

Engineering
Ticket Comment Body

The plain text description used as the initial comment on the ticket, attributed to the assignee.

This is an example Comment.
Ticket Comment HTML Body

The HTML-formatted description used as the initial comment on the ticket, attributed to the assignee.

<p>This is an example Comment.</p>
Ticket Priority

The urgency level assigned to the ticket.

Ticket Status

The current workflow status of the ticket.

Ticket Subject

The summary line shown at the top of the ticket.

This is an example ticket subject.
Ticket Type

The classification of the ticket.

Connection

The Zendesk connection to use.

Example Payload for Create Ticket
Loading…

Create Topic

Create a new topic in the Help Center. | key: createTopic

InputNotesExample
Topic Description

The descriptive text shown below the topic title.

Example Description
Topic Name

The display name of the topic.

Example Topic
Connection

The Zendesk connection to use.

Example Payload for Create Topic
Loading…

Create Topic Subscription

Create a new topic subscription in the Help Center. | key: createTopicSubscription

InputNotesExample
Include Comments

When true, the subscription also includes notifications for comments.

false
Topic ID

The unique identifier for the topic.

12
User ID

The ID of the user to subscribe to the topic. If none provided, the API assumes the current user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Create Topic Subscription
Loading…

Create User

Create a new user. | key: createUser

InputNotesExample
External ID

A unique identifier from another system. The API treats the ID as case sensitive — for example, "ian1" and "Ian1" are different users.

Moderator

When true, the user is granted moderator permissions.

false
Verified

When true, marks at least one of the user's identities as verified.

false
Organization ID

The unique identifier for the organization.

Alias

The display alias shown for the user instead of the real name.

Example Alias
Details

Additional details attached to the user record, visible to agents.

These are some example user details
Email Address

The email address for the user. Must be unique within the Zendesk domain.

someone@example.com
Name

The full name of the user.

John Doe
Notes

Free-form notes attached to the user record, visible to agents.

These are some example notes.
Phone Number

The phone number associated with the user.

15554008989
User Role

The permission level granted to the user.

Connection

The Zendesk connection to use.

Example Payload for Create User
Loading…

Create Webhook

Create a webhook in Zendesk to receive notifications of changes to users, organizations, or tickets. | key: createWebhook

InputNotesExample
Allow Duplicates?false
Callback URL

The URL to send data to

Events

The list of events that trigger the webhook to fire.

Webhook Name

A unique name to assign this webhook

Connection

The Zendesk connection to use.

Example Payload for Create Webhook
Loading…

Create Webhook Trigger

Create a Zendesk trigger that fires a webhook. | key: createWebhookTrigger

InputNotesExample
Allow Duplicates?

Allow a duplicate trigger with the same title to be created?

false
Trigger Conditions

The conditions under which this trigger will fire. Leave the default to fire under any change.

{
  "all": [],
  "any": [
    {
      "field": "status",
      "operator": "changed"
    },
    {
      "field": "status",
      "operator": "not_changed"
    }
  ]
}
Connection

The Zendesk connection to use.

Webhook Message Body

The body to send to the webhook. See Zendesk Support documentation for placeholder references.

{
  "current_user": {
    "details": "{{current_user.details}}",
    "email": "{{current_user.email}}",
    "external_id": "{{current_user.external_id}}",
    "first_name": "{{current_user.first_name}}",
    "language": "{{current_user.language}}",
    "name": "{{current_user.name}}",
    "notes": "{{current_user.notes}}",
    "organization.details": "{{current_user.organization.details}}",
    "organization.name": "{{current_user.organization.name}}",
    "organization.notes": "{{current_user.organization.notes}}",
    "phone": "{{current_user.phone}}",
    "tags": "{{current_user.tags}}"
  },
  "ticket": {
    "account": "{{ticket.account}}",
    "assignee": {
      "first_name": "{{ticket.assignee.first_name}}",
      "last_name": "{{ticket.assignee.last_name}}",
      "name": "{{ticket.assignee.name}}"
    },
    "brand": {
      "name": "{{ticket.brand.name}}"
    },
    "cc_names": "{{ticket.cc_names}}",
    "ccs": "{{ticket.ccs}}",
    "comments_formatted": "{{ticket.comments_formatted}}",
    "description": "{{ticket.description}}",
    "due_date": "{{ticket.due_date}}",
    "email_cc_names": "{{ticket.email_cc_names}}",
    "email_ccs": "{{ticket.email_ccs}}",
    "external_id": "{{ticket.external_id}}",
    "follower_names": "{{ticket.follower_names}}",
    "follower_reply_type_message": "{{ticket.follower_reply_type_message}}",
    "followers": "{{ticket.followers}}",
    "group": {
      "name": "{{ticket.group.name}}"
    },
    "id": "{{ticket.id}}",
    "in_business_hours": "{{ticket.in_business_hours}}",
    "latest_comment_formatted": "{{ticket.latest_comment_formatted}}",
    "latest_public_comment_formatted": "{{ticket.latest_public_comment_formatted}}",
    "link": "{{ticket.link}}",
    "organization": {
      "external_id": "{{ticket.organization.external_id}}",
      "name": "{{ticket.organization.name}}"
    },
    "priority": "{{ticket.priority}}",
    "public_comments_formatted": "{{ticket.public_comments_formatted}}",
    "requester": {
      "email": "{{ticket.requester.email}}",
      "external_id": "{{ticket.requester.external_id}}",
      "first_name": "{{ticket.requester.first_name}}",
      "language": "{{ticket.requester.language}}",
      "last_name": "{{ticket.requester.last_name}}",
      "name": "{{ticket.requester.name}}",
      "phone": "{{ticket.requester.phone}}"
    },
    "status": "{{ticket.status}}",
    "tags": "{{ticket.tags}}",
    "ticket_field_ID": "{{ticket.ticket_field_ID}}",
    "ticket_field_option_title_ID": "{{ticket.ticket_field_option_title_ID}}",
    "ticket_form": "{{ticket.ticket_form}}",
    "ticket_type": "{{ticket.ticket_type}}",
    "title": "{{ticket.title}}",
    "via": "{{ticket.via}}"
  }
}
Trigger Name
Webhook ID01GK7R2DBS16XB76SPDEXAMPLE
Example Payload for Create Webhook Trigger
Loading…

Delete Article Attachment

Delete an existing article attachment. | key: deleteArticleAttachment

InputNotesExample
Article Attachment ID

The unique identifier for the article attachment.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Article Attachment
Loading…

Delete Article Subscription

Delete a subscription to an article in the Help Center. | key: deleteArticleSubscription

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Locale

The locale of the article. If not provided, the default locale is used.

Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Article Subscription
Loading…

Delete Category

Delete a category in the Help Center. | key: deleteCategory

InputNotesExample
Category ID

The unique identifier for the category.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Category
Loading…

Delete Instance Webhooks

Delete all webhooks pointing to this instance. | key: deleteInstanceWebhooks

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for Delete Instance Webhooks
Loading…

Delete Post

Delete a post in the Help Center. | key: deletePost

InputNotesExample
Post ID

The unique identifier for the post.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Post
Loading…

Delete Post Subscription

Delete a post subscription in the Help Center. | key: deletePostSubscription

InputNotesExample
Post ID

The unique identifier for the post.

12
Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Post Subscription
Loading…

Delete Section

Delete a section in the Help Center. (warning: deleting a section also deletes all its articles). | key: deleteSection

InputNotesExample
Locale

The locale code for the resource.

en-us
Section ID

The unique identifier for the section.

123123213
Connection

The Zendesk connection to use.

Example Payload for Delete Section
Loading…

Delete Section Subscription

Delete a section subscription in the Help Center. | key: deleteSectionSubscription

InputNotesExample
Section ID

The unique identifier for the section.

123123213
Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Section Subscription
Loading…

Delete Ticket

Delete a ticket by ID. | key: deleteTicket

InputNotesExample
Ticket ID

The unique identifier for the ticket.

ExampleTicketId
Connection

The Zendesk connection to use.

Example Payload for Delete Ticket
Loading…

Delete Topic

Delete a topic from the Help Center. | key: deleteTopic

InputNotesExample
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Topic
Loading…

Delete Topic Subscription

Delete a topic subscription in the Help Center. | key: deleteTopicSubscription

InputNotesExample
Subscription ID

The unique identifier for the subscription.

12
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for Delete Topic Subscription
Loading…

Delete User

Delete a user by ID. | key: deleteUser

InputNotesExample
User ID

The unique identifier for the user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Delete User
Loading…

Delete Webhook

Delete a webhook by ID. | key: deleteWebhook

InputNotesExample
Webhook ID01GK59HW1XMB8WVZ43RPVAPXRM
Connection

The Zendesk connection to use.

Example Payload for Delete Webhook
Loading…

Get Article

Get an article from the Help Center. | key: showArticle

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Locale

The locale of the articles to retrieve. Defaults to 'en-us'.

en-us
Connection

The Zendesk connection to use.

Example Payload for Get Article
Loading…

Get Article Attachment

Get the properties of an attachment on an article in the Help Center. | key: getArticleAttachment

InputNotesExample
Article Attachment ID

The unique identifier for the article attachment.

12
Article ID

The unique identifier for the article.

123123213
Connection

The Zendesk connection to use.

Example Payload for Get Article Attachment
Loading…

Get Article Subscription

Get an article subscription from the Help Center. | key: getArticleSubscription

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Locale

The locale of the article. If not provided, the default locale is used.

Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Get Article Subscription
Loading…

Get Category

Get a category from the Help Center. | key: getCategory

InputNotesExample
Category ID

The unique identifier for the category.

12
Locale

The locale code for the resource.

en-us
Connection

The Zendesk connection to use.

Example Payload for Get Category
Loading…

Get Post

Get a post from the Help Center. | key: getPost

InputNotesExample
Post ID

The unique identifier for the post.

12
Connection

The Zendesk connection to use.

Example Payload for Get Post
Loading…

Get Post Subscription

Get a post subscription from the Help Center. | key: getPostSubscription

InputNotesExample
Post ID

The unique identifier for the post.

12
Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Get Post Subscription
Loading…

Get Section

Get a section from the Help Center. | key: getSection

InputNotesExample
Locale

The locale code for the resource.

en-us
Section ID

The unique identifier for the section.

123123213
Connection

The Zendesk connection to use.

Example Payload for Get Section
Loading…

Get Section Subscription

Get a section subscription from the Help Center. | key: getSectionSubscription

InputNotesExample
Section ID

The unique identifier for the section.

123123213
Subscription ID

The unique identifier for the subscription.

12
Connection

The Zendesk connection to use.

Example Payload for Get Section Subscription
Loading…

Get Ticket

Get a ticket by ID. | key: showTicket

InputNotesExample
Ticket ID

The unique identifier for the ticket.

ExampleTicketId
Connection

The Zendesk connection to use.

Example Payload for Get Ticket
Loading…

Get Ticket By External ID

Get a ticket by external ID. | key: getByExternalId

InputNotesExample
External ID

The identifier for the issue from an external system.

Connection

The Zendesk connection to use.

Example Payload for Get Ticket By External ID
Loading…

Get Topic

Get a topic from the Help Center. | key: getTopic

InputNotesExample
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for Get Topic
Loading…

Get Topic Subscription

Get a topic subscription from the Help Center. | key: getTopicSubscription

InputNotesExample
Subscription ID

The unique identifier for the subscription.

12
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for Get Topic Subscription
Loading…

Get User

Get a user by ID. | key: showUser

InputNotesExample
User ID

The unique identifier for the user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for Get User
Loading…

List Article Attachments

List all attachments for an article in the Help Center. | key: listArticleAttachments

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Connection

The Zendesk connection to use.

Example Payload for List Article Attachments
Loading…

List Article Subscriptions

List all subscriptions for an article in the Help Center. | key: listArticleSubscriptions

InputNotesExample
Article ID

The unique identifier for the article.

123123213
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Connection

The Zendesk connection to use.

Example Payload for List Article Subscriptions
Loading…

List Articles

List all articles in the Help Center. | key: listArticles

InputNotesExample
Label Names

Restrict results to articles with the specified labels. A maximum of 10 labels can be supplied. See label names for more information.

examplelabel1
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Locale

The locale of the articles to retrieve. Defaults to 'en-us'.

en-us
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Sort By

The field to sort the articles by.

Sort Order

The direction used to order the results.

asc
Start Time

The start time to filter articles by.

1779831652199
Connection

The Zendesk connection to use.

Example Payload for List Articles
Loading…

List Categories

List all categories in the Help Center. | key: listCategories

InputNotesExample
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Locale

The locale code for the resource.

en-us
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Sort By

The field used to sort the results.

Sort Order

The direction used to order the results.

asc
Connection

The Zendesk connection to use.

Example Payload for List Categories
Loading…

List Post Subscriptions

List all post subscriptions in the Help Center. | key: listPostSubscriptions

InputNotesExample
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Post ID

The unique identifier for the post.

12
Connection

The Zendesk connection to use.

Example Payload for List Post Subscriptions
Loading…

List Posts

List all posts in the Help Center. | key: listPosts

InputNotesExample
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Filter By

The field used to filter the results.

Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Sort By

The field used to sort the results.

Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for List Posts
Loading…

List Section Subscriptions

List all section subscriptions in the Help Center. | key: listSectionSubscriptions

InputNotesExample
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Section ID

The unique identifier for the section.

123123213
Connection

The Zendesk connection to use.

Example Payload for List Section Subscriptions
Loading…

List Sections

Lists all the sections in the Help Center or in a specific category. | key: listSections

InputNotesExample
Category ID

Input a categoryId to filter out sections by the ID provided.

12
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Locale

The locale code for the resource.

en-us
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Sort By

The field used to sort the results.

Sort Order

The direction used to order the results.

asc
Connection

The Zendesk connection to use.

Example Payload for List Sections
Loading…

List Tickets

List all tickets. | key: listTickets

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for List Tickets
Loading…

List Tickets Assigned To User

List all of the tickets that have been assigned to a particular user. | key: listTicketsToUser

InputNotesExample
User ID

The unique identifier for the user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for List Tickets Assigned To User
Loading…

List Tickets Requested By User

List all of the tickets that a particular user has requested. | key: listTicketsByUser

InputNotesExample
User ID

The unique identifier for the user.

488042375842
Connection

The Zendesk connection to use.

Example Payload for List Tickets Requested By User
Loading…

List Topic Subscriptions

List all topic subscriptions in the Help Center. | key: listTopicSubscriptions

InputNotesExample
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for List Topic Subscriptions
Loading…

List Topics

List all topics in the Help Center. | key: listTopics

InputNotesExample
Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
Fetch All

When true, automatically fetches all pages of results instead of returning a single page.

false
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Connection

The Zendesk connection to use.

Example Payload for List Topics
Loading…

List Triggers

List all workflow triggers configured in Zendesk. | key: listTriggers

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for List Triggers
Loading…

List Users

List all users. | key: listUsers

InputNotesExample
Connection

The Zendesk connection to use.

Example Payload for List Users
Loading…

List Webhooks

List all webhooks configured in Zendesk. | key: listWebhooks

InputNotesExample
Show only instance webhooks

Show only webhooks that point to this instance

true
Connection

The Zendesk connection to use.

Example Payload for List Webhooks
Loading…

Raw Request

Send a raw HTTP request to Zendesk. | key: rawRequest

InputNotesExample
Connection

The Zendesk connection to use.

Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
Debug Request

Enabling this flag will log out the current request.

false
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/users), The base URL is already included with your proper Zendesk domain (https://YOUR-ZENDESK-DOMAIN.zendesk.com/api/v2). For example, to connect to https://YOUR-ZENDESK-DOMAIN.zendesk.com/api/v2/users, only /users is entered in this field.

/users
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

The Raw Request action allows interaction with API endpoints that are not covered by other actions. For example, to list groups, which has an endpoint of /api/v2/groups, enter /groups as the endpoint and select the GET verb.

Example Payload for Raw Request
Loading…

Search Articles

Search for articles in the Help Center. | key: searchArticles

InputNotesExample
Brand IDs

Restrict the search to articles or posts within these brands.

63
Category IDs

Restrict the search to articles or posts within these categories.

63
Created After

The lower bound used to filter results by creation date. Format: YYYY-MM-DD.

2024-05-01
Created At

The exact creation date used to filter the results. Format: YYYY-MM-DD.

2024-05-01
Created Before

The upper bound used to filter results by creation date. Format: YYYY-MM-DD.

2024-05-01
Label Names

The list of label names used to filter the results.

examplelabel1
Locales

The locale to filter the results by.

en-us
Section ID

The unique identifier for the section used to filter the results.

12
Updated After

The lower bound used to filter results by update date. Format: YYYY-MM-DD.

2024-05-01
Updated At

The exact update date used to filter the results. Format: YYYY-MM-DD.

2024-05-01
Updated Before

The upper bound used to filter results by update date. Format: YYYY-MM-DD.

2024-05-01
Search Query

The text or search string used to match results.

carrot
Multibrand

When true, results are filtered across all brands in the account.

false
Sort By

The field used to sort the results.

Sort Order

The direction used to order the results.

asc
Connection

The Zendesk connection to use.

Example Payload for Search Articles
Loading…

Search Posts

Search posts in the Help Center. | key: searchPosts

InputNotesExample
Created After

The lower bound used to filter results by creation date. Format: YYYY-MM-DD.

2024-05-01
Created At

The exact creation date used to filter the results. Format: YYYY-MM-DD.

2024-05-01
Created Before

The upper bound used to filter results by creation date. Format: YYYY-MM-DD.

2024-05-01
Updated After

The lower bound used to filter results by update date. Format: YYYY-MM-DD.

2024-05-01
Updated At

The exact update date used to filter the results. Format: YYYY-MM-DD.

2024-05-01
Updated Before

The upper bound used to filter results by update date. Format: YYYY-MM-DD.

2024-05-01
Search Query

The text or search string used to match results.

carrot
Sort By

The field used to sort the results.

Sort Order

The direction used to order the results.

asc
Topic ID

The ID of the topic to filter posts by.

12
Connection

The Zendesk connection to use.

Example Payload for Search Posts
Loading…

Search Users

Return an array of users who meet the search criteria. | key: searchUsers

InputNotesExample
External ID

The external_id parameter does not support the search syntax. It only accepts ids.

Query

The search query supporting Zendesk search syntax. Accepts a partial or full value of any user property, including name, email address, notes, or phone. Example: query="jdoe".

Connection

The Zendesk connection to use.

Example Payload for Search Users
Loading…

Unified Search

Search for knowledge base articles, community posts, and external records in the Help Center. | key: unifiedSearch

InputNotesExample
Brand IDs

Restrict the search to articles or posts within these brands.

63
Category IDs

Restrict the search to articles or posts within these categories.

63
Content Types

Restrict the search to one of these content types: ARTICLE, POST.

Pagination Cursor

The pagination cursor from a previous request. If omitted, the first page is returned.

aQAAAAAAAAAAZPPgaGUAAAAAaZo+HCjcBQAA
External Source IDs

Restrict the search results to the specified external source or sources.

63
Locales

Restrict the search to articles or posts within these locales.

en-us
Page Limit

The number of results to return per page. The maximum is 100; any greater value is capped at 100.

100
Search Query

The text or search string used to match results.

carrot
Section IDs

Restrict the search to articles or posts within these sections.

63
Topic IDs

Restrict the search to posts within these topics.

63
Connection

The Zendesk connection to use.

Example Payload for Unified Search
Loading…

Update Article

Update an existing article's metadata in the Help Center. | key: updateArticle

InputNotesExample
Body

The main content of the article.

Example Body
Article ID

The unique identifier for the article.

123123213
Title

The headline displayed for the article.

Example Title
Author ID

The unique identifier for the author.

12
Comments Disabled

When true, prevents users from leaving comments on the object.

Content Tag IDs

The list of content tag IDs to attach to the object.

Label Names

The list of label names to attach to the object.

Locale

The locale code for the resource.

en-us
Permission Group ID

The unique identifier for the permission group.

15
Position

The numeric ordering position of the object within its list.

42
Promoted

When true, the object is highlighted at the top of its list.

Section ID

The unique identifier for the section.

123123213
User Segment ID

The unique identifier for the user segment.

15
Connection

The Zendesk connection to use.

Example Payload for Update Article
Loading…

Update Category

Update a category in the Help Center. | key: updateCategory

InputNotesExample
Category Description

The description of the category to be updated.

Example Description
Category ID

The unique identifier for the category.

12
Category Name

The name of the category to be updated.

Example Category
Locale

The locale of the category to be updated.

en-us
Position

The position of the category to be updated.

42
Connection

The Zendesk connection to use.

Example Payload for Update Category
Loading…

Update Post

Update a post in the Help Center. | key: updatePost

InputNotesExample
Content Tag IDs

The list of content tag IDs to attach to the object.

Closed

When true, the post is closed to new comments.

Featured

When true, the post is featured prominently in the community.

Pinned

When true, the post is pinned to the top of its topic.

Details

The main body content of the post.

Post ID

The unique identifier for the post.

12
Status

The current workflow state of the post.

Title

The headline displayed for the post.

Example Title
Topic ID

The unique identifier for the topic.

12
Connection

The Zendesk connection to use.

Example Payload for Update Post
Loading…

Update Section

Update a section in the Help Center. | key: updateSection

InputNotesExample
Category ID

Category ID of the Section to update.

12
Locale

The locale code for the resource.

en-us
Parent Section ID

Parent Section ID of the Section to update.

12
Position

Position of the Section to update.

42
Section Description

Description of the Section to update.

Example Description
Section ID

The unique identifier for the section.

123123213
Section Name

Name of the Section to update.

Example Section
Connection

The Zendesk connection to use.

Example Payload for Update Section
Loading…

Update Ticket

Update a ticket by ID. | key: updateTicket

InputNotesExample
Assignee Email

The email address of the user assigned to the ticket.

Jane.Doe@example.com
Assignee ID

The unique identifier for the user assigned to the ticket.

403598029853443232
File

The file contents to attach to the comment, accepted as either a string or a binary payload.

File Name

The display name to use for the uploaded file.

Requester Organization ID

The unique identifier for the organization the requester belongs to.

488042375842
Tags

The list of tags to attach to the resource.

Engineering
Ticket Comment Body

The plain text description used as the initial comment on the ticket, attributed to the assignee.

This is an example Comment.
Ticket Comment HTML Body

The HTML-formatted description used as the initial comment on the ticket, attributed to the assignee.

<p>This is an example Comment.</p>
Ticket ID

The unique identifier for the ticket.

ExampleTicketId
Ticket Priority

The urgency level assigned to the ticket.

Ticket Status

The current workflow status of the ticket.

Ticket Subject

The summary line shown at the top of the ticket.

This is an example ticket subject.
Ticket Type

The classification of the ticket.

Connection

The Zendesk connection to use.

Example Payload for Update Ticket
Loading…

Update Topic

Update a topic in the Help Center. | key: updateTopic

InputNotesExample
Manageable By

The user segment allowed to manage the topic.

Position

The position of the topic in the list of topics.

42
Topic Description

The descriptive text shown below the topic title.

Example Description
Topic ID

The unique identifier for the topic.

12
Topic Name

The display name of the topic.

Example Topic
User Segment ID

The user segment ID to associate with the topic.

15
Connection

The Zendesk connection to use.

Example Payload for Update Topic
Loading…

Update User

Update a user by ID. | key: updateUser

InputNotesExample
External ID

A unique identifier from another system. The API treats the ID as case sensitive — for example, "ian1" and "Ian1" are different users.

Moderator

When true, the user is granted moderator permissions.

Verified

When true, marks at least one of the user's identities as verified.

Organization ID

The unique identifier for the organization.

Alias

The display alias shown for the user instead of the real name.

Example Alias
Details

Additional details attached to the user record, visible to agents.

These are some example user details
Email Address

The email address for the user. Must be unique within the Zendesk domain.

someone@example.com
User ID

The unique identifier for the user.

488042375842
Name

The full name of the user.

John Doe
Notes

Free-form notes attached to the user record, visible to agents.

These are some example notes.
Phone Number

The phone number associated with the user.

15554008989
User Role

The permission level granted to the user.

Time Zone

The time zone the user operates in.

Berlin
Connection

The Zendesk connection to use.

Updating a user's 'User Role' from an end-user to administrator may cause a failed execution. For more information refer to the user permissions guide in the Zendesk docs.

Example Payload for Update User
Loading…

Changelog

2026-05-26

Added the New and Updated Tickets polling trigger using the Zendesk Incremental Tickets Export cursor stream. The trigger drains pages until end_of_stream and persists both the cursor and the last polled timestamp for accurate created vs. updated partitioning

2026-04-30

Various modernizations and documentation updates

2026-03-16

Improved input field documentation with formatted URL links for better readability

2026-03-13

Enhanced OAuth 2.0 connections with PKCE S256 support for improved authorization security. Removed the Debug Request input from all action inputs.

2026-03-05

Added inline data sources for topic, article, section, and post subscriptions to enable dynamic dropdown selection

2026-02-26

Added inline data sources for users, tickets, topics, and posts to enable dynamic dropdown selection

2025-11-19

Enhanced webhook triggers to support simulated test executions

2025-08-04

Security improvements to the API token connection