Zendesk Connector

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.

Connections

API Token

Authenticate requests using an API token.

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/

Input	Comments	Default
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).
Username	Your Zendesk username. (Email address used to login to Zendesk).
API Token	Your generated API token from Zendesk.

OAuth 2.0

Authenticate using OAuth 2.0.

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.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
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).
Scopes		read write
Client ID
Client Secret

OAuth 2.0 (Deprecated)

Authenticate using OAuth 2.0. (Deprecated)

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/

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Authorize URL	The OAuth 2.0 Authorization URL for Zendesk.	https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/authorizations/new
Token URL	The OAuth 2.0 Token URL for Zendesk.	https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/tokens
Scopes	A space-delimited set of one or more scopes to get the user's permission to access.	read write
Client ID
Client Secret

Triggers

New and Updated Tickets

Checks for new and updated tickets in Zendesk on a configured schedule.

Input	Comments	Default
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

Webhook

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

Input	Comments	Default
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.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article ID	The unique identifier for the article.
Locale	The locale code for the resource.	en-us
Attachment IDs	The list of attachment IDs to attach to the object.

Create Article

Create a new article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Section ID	The unique identifier for the section.
Title	The headline displayed for the article.
User Segment ID	The unique identifier for the user segment.
Permission Group ID	The unique identifier for the permission group.
Body	The main content of the article.
Draft	When true, the article is saved as a draft instead of published.	false
Notify Subscribers	When false, suppresses the article creation email to subscribers. Useful when creating many articles at once.	false

Create Article Attachment

Create an attachment for an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
File Name	The display name to use for the uploaded file.
File	The File Attachment to upload.
Inline	When true, the attachment is rendered inline within the content.	false
Article ID	The unique identifier for the article.

Create Article Subscription

Create a subscription to an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article ID	The unique identifier for the article.
User ID	The ID of the user to subscribe to the section. If none provided, the API assumes the current user.
Locale	The locale of the article. If not provided, the default locale is used.

Create Category

Create a category in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Category Name	The display name of the category.
Category Description	The descriptive text shown below the category title.
Locale	The locale code for the resource.	en-us
Position	The position of the category to be created.

Create Post

Create a new post in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The ID of the topic to create the post in.
Title	The headline displayed for the post.
Details	The main body content of the post.
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
Status	The current workflow state of the post.
Notify Subscribers	When false, suppresses the article creation email to subscribers. Useful when creating many articles at once.	false
Content Tag IDs	The list of content tag IDs to attach to the object.

Create Post Subscription

Create a post subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.
User ID	The ID of the user to subscribe to the post. If none provided, the API assumes the current user.

Create Section

Create a section in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Category ID	The unique identifier for the category.
Section Name	The display name of the section.
Section Description	The descriptive text shown below the section title.
Position	The position of the section.

Create Section Subscription

Create a section subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Section ID	The unique identifier for the section.
User ID	The ID of the user to subscribe to the section. If none provided, the API assumes the current user.
Locale	The locale of the section. If not provided, the default locale is used.
Include Comments	When true, the subscription also includes notifications for comments.	false

Create Ticket

Create a new ticket.

Input	Comments	Default
Requester Name	The full name of the person requesting the ticket.
Requester Email	The email address of the person requesting the ticket.
Assignee ID	The unique identifier for the user assigned to the ticket.
Recipient Email	The email address of the ticket recipient.
Ticket Subject	The summary line shown at the top of the ticket.
Ticket Priority	The urgency level assigned to the ticket.
Ticket Status	The current workflow status of the ticket.
Ticket Comment Body	The plain text description used as the initial comment on the ticket, attributed to the assignee.
Ticket Comment HTML Body	The HTML-formatted description used as the initial comment on the ticket, attributed to the assignee.
Tags	The list of tags to attach to the resource.
Ticket Type	The classification of the ticket.
Requester Organization ID	The unique identifier for the organization the requester belongs to.
Followers	The list of user IDs to add as followers on the issue.
Connection	The Zendesk connection to use.
External ID	The ID of this issue from an external system

Create Topic

Create a new topic in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic Name	The display name of the topic.
Topic Description	The descriptive text shown below the topic title.

Create Topic Subscription

Create a new topic subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The unique identifier for the topic.
User ID	The ID of the user to subscribe to the topic. If none provided, the API assumes the current user.
Include Comments	When true, the subscription also includes notifications for comments.	false

Create User

Create a new user.

Input	Comments	Default
Name	The full name of the user.
Email Address	The email address for the user. Must be unique within the Zendesk domain.
User Role	The permission level granted to the user.
Phone Number	The phone number associated with the user.
External ID	A unique identifier from another system. The API treats the ID as case sensitive — for example, "ian1" and "Ian1" are different users.
Notes	Free-form notes attached to the user record, visible to agents.
Details	Additional details attached to the user record, visible to agents.
Moderator	When true, the user is granted moderator permissions.	false
Alias	The display alias shown for the user instead of the real name.
Verified	When true, marks at least one of the user's identities as verified.	false
Organization ID	The unique identifier for the organization.
Connection	The Zendesk connection to use.

Create Webhook

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

Input	Comments	Default
Connection	The Zendesk connection to use.
Callback URL	The URL to send data to
Webhook Name	A unique name to assign this webhook
Events	The list of events that trigger the webhook to fire.
Allow Duplicates?		false

Create Webhook Trigger

Create a Zendesk trigger that fires a webhook.

Input	Comments	Default
Connection	The Zendesk connection to use.
Trigger Name
Webhook ID
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 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" } ] }
Allow Duplicates?	Allow a duplicate trigger with the same title to be created?	false

Delete Article Attachment

Delete an existing article attachment.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article Attachment ID	The unique identifier for the article attachment.

Delete Article Subscription

Delete a subscription to an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Subscription ID	The unique identifier for the subscription.
Article ID	The unique identifier for the article.
Locale	The locale of the article. If not provided, the default locale is used.

Delete Category

Delete a category in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Category ID	The unique identifier for the category.

Delete Instance Webhooks

Delete all webhooks pointing to this instance.

Input	Comments	Default
Connection	The Zendesk connection to use.

Delete Post

Delete a post in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.

Delete Post Subscription

Delete a post subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.
Subscription ID	The unique identifier for the subscription.

Delete Section

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

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Section ID	The unique identifier for the section.

Delete Section Subscription

Delete a section subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Section ID	The unique identifier for the section.
Subscription ID	The unique identifier for the subscription.

Delete Ticket

Delete a ticket by ID.

Input	Comments	Default
Ticket ID	The unique identifier for the ticket.
Connection	The Zendesk connection to use.

Delete Topic

Delete a topic from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The unique identifier for the topic.

Delete Topic Subscription

Delete a topic subscription in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The unique identifier for the topic.
Subscription ID	The unique identifier for the subscription.

Delete User

Delete a user by ID.

Input	Comments	Default
User ID	The unique identifier for the user.
Connection	The Zendesk connection to use.

Delete Webhook

Delete a webhook by ID.

Input	Comments	Default
Connection	The Zendesk connection to use.
Webhook ID

Get Article

Get an article from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale of the articles to retrieve. Defaults to 'en-us'.	en-us
Article ID	The unique identifier for the article.

Get Article Attachment

Get the properties of an attachment on an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article ID	The unique identifier for the article.
Article Attachment ID	The unique identifier for the article attachment.

Get Article Subscription

Get an article subscription from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Subscription ID	The unique identifier for the subscription.
Article ID	The unique identifier for the article.
Locale	The locale of the article. If not provided, the default locale is used.

Get Category

Get a category from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Category ID	The unique identifier for the category.

Get Post

Get a post from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.

Get Post Subscription

Get a post subscription from the Help Center.

Input	Comments	Default
Post ID	The unique identifier for the post.
Subscription ID	The unique identifier for the subscription.
Connection	The Zendesk connection to use.

Get Section

Get a section from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Section ID	The unique identifier for the section.

Get Section Subscription

Get a section subscription from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Subscription ID	The unique identifier for the subscription.
Section ID	The unique identifier for the section.

Get Ticket

Get a ticket by ID.

Input	Comments	Default
Ticket ID	The unique identifier for the ticket.
Connection	The Zendesk connection to use.

Get Ticket By External ID

Get a ticket by external ID.

Input	Comments	Default
Connection	The Zendesk connection to use.
External ID	The identifier for the issue from an external system.

Get Topic

Get a topic from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The unique identifier for the topic.

Get Topic Subscription

Get a topic subscription from the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Subscription ID	The unique identifier for the subscription.
Topic ID	The unique identifier for the topic.

Get User

Get a user by ID.

Input	Comments	Default
User ID	The unique identifier for the user.
Connection	The Zendesk connection to use.

List Article Attachments

List all attachments for an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article ID	The unique identifier for the article.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Articles

List all articles in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale of the articles to retrieve. Defaults to 'en-us'.	en-us
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Sort By	The field to sort the articles by.
Sort Order	The direction used to order the results.
Label Names	Restrict results to articles with the specified labels. A maximum of 10 labels can be supplied. See label names for more information.
Start Time	The start time to filter articles by.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Article Subscriptions

List all subscriptions for an article in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Article ID	The unique identifier for the article.

List Categories

List all categories in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Sort By	The field used to sort the results.
Sort Order	The direction used to order the results.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Posts

List all posts in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Filter By	The field used to filter the results.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Topic ID	The unique identifier for the topic.
Sort By	The field used to sort the results.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Post Subscriptions

List all post subscriptions in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.

List Sections

Lists all the sections in the Help Center or in a specific category.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Category ID	Input a categoryId to filter out sections by the ID provided.
Sort By	The field used to sort the results.
Sort Order	The direction used to order the results.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Section Subscriptions

List all section subscriptions in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Section ID	The unique identifier for the section.

List Tickets

List all tickets.

Input	Comments	Default
Connection	The Zendesk connection to use.

List Tickets Assigned To User

List all of the tickets that have been assigned to a particular user.

Input	Comments	Default
User ID	The unique identifier for the user.
Connection	The Zendesk connection to use.

List Tickets Requested By User

List all of the tickets that a particular user has requested.

Input	Comments	Default
User ID	The unique identifier for the user.
Connection	The Zendesk connection to use.

List Topics

List all topics in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.
Fetch All	When true, automatically fetches all pages of results instead of returning a single page.	false

List Topic Subscriptions

List all topic subscriptions in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Topic ID	The unique identifier for the topic.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.

List Triggers

List all workflow triggers configured in Zendesk.

Input	Comments	Default
Connection	The Zendesk connection to use.

List Users

List all users.

Input	Comments	Default
Connection	The Zendesk connection to use.

List Webhooks

List all webhooks configured in Zendesk.

Input	Comments	Default
Connection	The Zendesk connection to use.
Show only instance webhooks	Show only webhooks that point to this instance	true

Raw Request

Send a raw HTTP request to Zendesk.

Input	Comments	Default
Connection	The Zendesk connection to use.
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.
Method	The HTTP method to use.
Data	The HTTP body payload to send to the URL.
Form Data	The Form Data to be sent as a multipart form upload.
File Data	File Data to be sent as a multipart form upload.
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
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.
Header	A list of headers to send with the request.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Timeout	The maximum time that a client will await a response to its request
Debug Request	Enabling this flag will log out the current request.	false
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
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
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Search Articles

Search for articles in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locales	The locale to filter the results by.
Search Query	The text or search string used to match results.
Brand IDs	Restrict the search to articles or posts within these brands.
Category IDs	Restrict the search to articles or posts within these categories.
Section ID	The unique identifier for the section used to filter the results.
Created After	The lower bound used to filter results by creation date. Format: YYYY-MM-DD.
Created At	The exact creation date used to filter the results. Format: YYYY-MM-DD.
Created Before	The upper bound used to filter results by creation date. Format: YYYY-MM-DD.
Label Names	The list of label names used to filter the results.
Updated At	The exact update date used to filter the results. Format: YYYY-MM-DD.
Updated Before	The upper bound used to filter results by update date. Format: YYYY-MM-DD.
Updated After	The lower bound used to filter results by update date. Format: YYYY-MM-DD.
Multibrand	When true, results are filtered across all brands in the account.	false
Sort Order	The direction used to order the results.
Sort By	The field used to sort the results.

Search Posts

Search posts in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The ID of the topic to filter posts by.
Search Query	The text or search string used to match results.
Created At	The exact creation date used to filter the results. Format: YYYY-MM-DD.
Created Before	The upper bound used to filter results by creation date. Format: YYYY-MM-DD.
Created After	The lower bound used to filter results by creation date. Format: YYYY-MM-DD.
Sort By	The field used to sort the results.
Updated After	The lower bound used to filter results by update date. Format: YYYY-MM-DD.
Updated At	The exact update date used to filter the results. Format: YYYY-MM-DD.
Updated Before	The upper bound used to filter results by update date. Format: YYYY-MM-DD.
Sort Order	The direction used to order the results.

Search Users

Return an array of users who meet the search criteria.

Input	Comments	Default
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.

Unified Search

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

Input	Comments	Default
Connection	The Zendesk connection to use.
Locales	Restrict the search to articles or posts within these locales.
Search Query	The text or search string used to match results.
Brand IDs	Restrict the search to articles or posts within these brands.
Category IDs	Restrict the search to articles or posts within these categories.
Content Types	Restrict the search to one of these content types: ARTICLE, POST.
External Source IDs	Restrict the search results to the specified external source or sources.
Section IDs	Restrict the search to articles or posts within these sections.
Topic IDs	Restrict the search to posts within these topics.
Pagination Cursor	The pagination cursor from a previous request. If omitted, the first page is returned.
Page Limit	The number of results to return per page. The maximum is 100; any greater value is capped at 100.

Update Article

Update an existing article's metadata in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Article ID	The unique identifier for the article.
Section ID	The unique identifier for the section.
Author ID	The unique identifier for the author.
Title	The headline displayed for the article.
Body	The main content of the article.
Permission Group ID	The unique identifier for the permission group.
User Segment ID	The unique identifier for the user segment.
Locale	The locale code for the resource.	en-us
Promoted	When true, the object is highlighted at the top of its list.
Position	The numeric ordering position of the object within its list.
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.

Update Category

Update a category in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Category ID	The unique identifier for the category.
Locale	The locale of the category to be updated.	en-us
Category Name	The name of the category to be updated.
Category Description	The description of the category to be updated.
Position	The position of the category to be updated.

Update Post

Update a post in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Post ID	The unique identifier for the post.
Title	The headline displayed for the post.
Details	The main body content of the post.
Status	The current workflow state of the post.
Topic ID	The unique identifier for the topic.
Featured	When true, the post is featured prominently in the community.
Pinned	When true, the post is pinned to the top of its topic.
Closed	When true, the post is closed to new comments.
Content Tag IDs	The list of content tag IDs to attach to the object.

Update Section

Update a section in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Locale	The locale code for the resource.	en-us
Section ID	The unique identifier for the section.
Section Name	Name of the Section to update.
Section Description	Description of the Section to update.
Position	Position of the Section to update.
Category ID	Category ID of the Section to update.
Parent Section ID	Parent Section ID of the Section to update.

Update Ticket

Update a ticket by ID.

Input	Comments	Default
Ticket ID	The unique identifier for the ticket.
Ticket Comment Body	The plain text description used as the initial comment on the ticket, attributed to the assignee.
Ticket Comment HTML Body	The HTML-formatted description used as the initial comment on the ticket, attributed to the assignee.
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.
Ticket Status	The current workflow status of the ticket.
Assignee Email	The email address of the user assigned to the ticket.
Assignee ID	The unique identifier for the user assigned to the ticket.
Tags	The list of tags to attach to the resource.
Ticket Type	The classification of the ticket.
Ticket Subject	The summary line shown at the top of the ticket.
Ticket Priority	The urgency level assigned to the ticket.
Requester Organization ID	The unique identifier for the organization the requester belongs to.
Connection	The Zendesk connection to use.

Update Topic

Update a topic in the Help Center.

Input	Comments	Default
Connection	The Zendesk connection to use.
Topic ID	The unique identifier for the topic.
Topic Name	The display name of the topic.
User Segment ID	The user segment ID to associate with the topic.
Position	The position of the topic in the list of topics.
Topic Description	The descriptive text shown below the topic title.
Manageable By	The user segment allowed to manage the topic.

Update User

Update a user by ID.

Input	Comments	Default
User ID	The unique identifier for the user.
User Role	The permission level granted to the user.
Name	The full name of the user.
Email Address	The email address for the user. Must be unique within the Zendesk domain.
Phone Number	The phone number associated with the user.
External ID	A unique identifier from another system. The API treats the ID as case sensitive — for example, "ian1" and "Ian1" are different users.
Notes	Free-form notes attached to the user record, visible to agents.
Details	Additional details attached to the user record, visible to agents.
Moderator	When true, the user is granted moderator permissions.
Alias	The display alias shown for the user instead of the real name.
Time Zone	The time zone the user operates in.
Verified	When true, marks at least one of the user's identities as verified.
Organization ID	The unique identifier for the organization.
Connection	The Zendesk connection to use.