V2NodesZendesk Support
Zendesk Support
V2

Zendesk Support

Provides integration with Zendesk Support using OAuth and the Ticketing API.

Revision History

0.0.0.11 - Initial release.

Connection

Use this Connection to store the Zendesk tenant and OAuth settings used by all Node methods.

Property Type Description
Subdomain String The Zendesk tenant subdomain, e.g. use contoso when the tenant URL is contoso.zendesk.com.
Client ID String The OAuth client identifier issued by Zendesk.
Client Secret Masked The OAuth client secret issued by Zendesk.
Access Token Masked The OAuth access token used for Zendesk Support API requests.
Refresh Token Masked The OAuth refresh token used to renew the access token.
Timeout (seconds) Integer The timeout used for OAuth token requests, Connection validation, and API calls.

Setup Notes

  1. Create or reuse a Zendesk OAuth client with access to the Ticketing API resources that your Workflow needs.
  2. Configure the OAuth client as a confidential client, then record the Client ID and Client Secret.
  3. Add the Flowgear OAuth callback URL to the Zendesk OAuth client's allowed redirect URLs.
  4. In Flowgear, create a Zendesk Support Connection and enter the Subdomain, Client ID, and Client Secret.
  5. Click Connect your Account, sign in to Zendesk, and authorize the application.
  6. Save and test the Connection.

The Node requests the read write OAuth scope. Connection validation calls Zendesk's current-user endpoint to confirm that the access token can reach the API.

Methods

The Node exposes template-driven Create, Retrieve, and Update methods for the curated Zendesk Support Ticketing API surface.

Create

Use Create for supported Zendesk Support POST operations, including ticket, user, and organization creation.

Parameter Type Description
Connection Connection Zendesk Support Connection details.
OperationId String The template-selected identifier for the operation to run.
Options Object Route and query values required by the selected operation.
Items Array Structured request body for the selected create operation.
Return Type Description
Response Array Normalized response rows for the selected operation.

Retrieve

Use Retrieve for supported Zendesk Support GET operations, including current user, tickets, ticket comments, users, organizations, and search export.

Parameter Type Description
Connection Connection Zendesk Support Connection details.
OperationId String The template-selected identifier for the operation to run.
Options Object Route and query values required by the selected operation.
Return Type Description
Response Array Normalized response rows for the selected operation.

Update

Use Update for supported Zendesk Support PUT operations, including ticket, user, and organization updates.

Parameter Type Description
Connection Connection Zendesk Support Connection details.
OperationId String The template-selected identifier for the operation to run.
Options Object Route and query values required by the selected operation.
Items Array Structured request body for the selected update operation.
Return Type Description
Response Array Normalized response rows for the selected operation.

Usage Notes

  • Templates populate OperationId and the expected Options values for the selected operation.
  • You can browse and expand templates without live Zendesk credentials because the Node uses an embedded OpenAPI document for template discovery.
  • Runtime API calls require a valid Zendesk Support Connection.
  • Cursor paging is handled internally for supported list and search-export operations. Workflow designers do not need to pass page, per_page, page[size], page[after], or page[before].
  • The search export template requires query and filter[type]. The supported filter[type] values are ticket, user, and organization.
  • Write templates expose curated body fields for tickets, users, and organizations instead of the full tenant-specific Zendesk schema.
  • Zendesk business fields that conflict with normalized Flowgear fields are preserved with provider-prefixed names, e.g. providerStatus.
  • Delete operations, ticket-comment write operations, and file uploads are not exposed by this V2 Node.

See also