Skip to main content

Zendesk Component

Manage Tickets and users in Zendesk

Component key: zendesk

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 you to manage Users and Tickets inside your Zendesk domain.

Zendesk Connections#

Zendesk Connection#

The Zendesk component authenticates requests with OAuth 2.0. To configure an application inside zendesk follow the directions in this guide Now, you will have to create a new Zendesk connection in Prismatic.

  • For Client ID enter in the unique identifier of your app inside the Zendesk admin dashboard. For Client Secret enter the generated client secret you received from the Zendesk admin dashboard.
  • For Scopes refer to the guide that was linked above. There is detailed information on picking the correct scope.

You can find your subdomain inside of your Zendesk URL: https://{YOUR SUBDOMAIN HERE}.zendesk.com/

InputDefaultNotesExample
Input
Authorize URL
string
/ Required
Default
https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/authorizations/new
Notes
The OAuth 2.0 Authorization URL for Zendesk
Example
https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/authorizations/new
Input
Client ID
string
/ Required
Default
 
Notes
 
Example
 
Input
Client Secret
password
/ Required
Default
 
Notes
 
Example
 
Input
Scopes
string
/ Required
Default
read write
Notes
A space-delimited set of one or more scopes to get the user's permission to access.
Example
read write
Input
Subdomain
string
/ Required
Default
 
Notes
Provide a string value for the subdomain that your site lives in. You can find your subdomain in your zendesk URL https://<SUBDOMAIN>.zendesk.com/admin/home
Example
acmeInc
Input
Token URL
string
/ Required
Default
https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/tokens
Notes
The OAuth 2.0 Token URL for Zendesk
Example
https://YOUR-ZENDESK-DOMAIN.zendesk.com/oauth/tokens

Actions#

Create Ticket#

Create a new ticket | key: createTicket

InputDefaultNotesExample
Input
Assignee Id
string
Default
 
Notes
Provide a valid user id for the assignee of the ticket.
Example
403598029853443232
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
External ID
string
Default
 
Notes
The ID of this issue from an external system
Example
 
Input
Followers
string
Value List
Default
 
Notes
For each item provide a unique identifier of the follower you want to add to the issue.
Example
488042375842
Input
Recipient Email
string
Default
 
Notes
Provide a string value for the name of the recipient.
Example
Jane.Doe@example-prismatic.io
Input
Requester Email
string
/ Required
Default
 
Notes
Provide a string value for the email of the requester.
Example
John.Doe@example-email.com
Input
Requester Name
string
/ Required
Default
 
Notes
provide a string value for the name of the requester.
Example
John Doe
Input
Requester Organization Id
string
Default
 
Notes
Provide an integer value to specify the Organization of the requester.
Example
488042375842
Input
Tags
string
Value List
Default
 
Notes
For each item, provide a string value for the tag.
Example
Engineering
Input
Ticket Comment Body
string
Default
 
Notes
When creating a ticket, this field can be used to give a ticket description. It will also leave a comment on the ticket from the assignee.
Example
This is an example Comment.
Input
Ticket Comment HTML Body
string
Default
 
Notes
When creating a ticket, this field can be used to give a ticket description using HTML. It will also leave a comment on the ticket from the assignee.
Example
<p>This is an example Comment.</p>
Input
Ticket Priority
string
Default
 
Notes
Provide a string value for the priority of the ticket.
Example
 
Input
Ticket Status
string
Default
 
Notes
Provide a string value for the status of the ticket.
Example
 
Input
Ticket Subject
string
Default
 
Notes
Provide a string value for the subject of the ticket
Example
This is an example ticket subject.
Input
Ticket Type
string
Default
 
Notes
Provide a string value for the type of the ticket.
Example
 
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Create User#

Create a new user | key: createUser

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
Moderator
boolean
Default
 
Notes
This flag specifies whether or not the user will have moderator permissions.
Example
 
Input
Verified
boolean
Default
 
Notes
Flip this flag to true if any of the user's identities is verified.
Example
 
Input
Organization Id
string
Default
 
Notes
Provide the unique identifier of the organization.
Example
 
Input
Alias
string
Default
 
Notes
Provide a string value that represents an alias to give to a user.
Example
Example Alias
Input
Details
string
Default
 
Notes
Provide a string value that represents details to be attached to the user.
Example
These are some example user details
Input
Email Address
string
/ Required
Default
 
Notes
Provide a valid email address for the user. Make sure this value does not conflict with any other users in your Zendesk Domain
Example
someone@example-prismatic.io
Input
Name
string
/ Required
Default
 
Notes
Provide a string value for the name of the user.
Example
John Doe
Input
Notes
string
Default
 
Notes
Provide a string value that represents notes to be attached to the user.
Example
These are some example notes.
Input
Phone Number
string
Default
 
Notes
Provide a valid phone number for the user.
Example
15554008989
Input
User Role
string
Default
 
Notes
Provide which level of permissions the user is granted.
Example
 
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Delete Ticket#

Delete the information and metadata of a ticket by Id | key: deleteTicket

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
Ticket Id
string
/ Required
Default
 
Notes
Provide the unique identifier for the ticket you would like to show.
Example
ExampleTicketId
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Delete User#

Delete the information and metadata of a user by Id | key: deleteUser

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
UserId
string
Default
 
Notes
Provide an integer value for the unique identifier of the user.
Example
488042375842
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Get Ticket By External ID#

Get a ticket by external ID | key: getByExternalId

InputDefaultNotes
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Input
External ID
string
Default
 
Notes
The ID of this issue from an external system
Input
Connection
connection
/ Required
Default
 
Notes
 

List Tickets#

List all Tickets | key: listTickets

InputDefaultNotes
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Input
Connection
connection
/ Required
Default
 
Notes
 

List Tickets Assigned To User#

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

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
UserId
string
Default
 
Notes
Provide an integer value for the unique identifier of the user.
Example
488042375842
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Output Example Payload#

{  "data": {    "tickets": [],    "count": 5,    "next_page": 5,    "previous_page": 5  }}

List Tickets Requested By User#

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

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
UserId
string
Default
 
Notes
Provide an integer value for the unique identifier of the user.
Example
488042375842
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Output Example Payload#

{  "data": {    "tickets": [],    "count": 5,    "next_page": 5,    "previous_page": 5  }}

List Users#

List all Users | key: listUsers

InputDefaultNotes
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Input
Connection
connection
/ Required
Default
 
Notes
 

Output Example Payload#

{  "data": {    "users": [],    "count": 5,    "next_page": 5,    "previous_page": 5  }}

Show Ticket#

Get the information and metadata of a ticket by Id | key: showTicket

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
Ticket Id
string
/ Required
Default
 
Notes
Provide the unique identifier for the ticket you would like to show.
Example
ExampleTicketId
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Show User#

Get the information and metadata of a user by Id | key: showUser

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
UserId
string
Default
 
Notes
Provide an integer value for the unique identifier of the user.
Example
488042375842
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Update Ticket#

Update the information and metadata of a ticket by Id | key: updateTicket

InputDefaultNotesExample
Input
Assignee Email
string
Default
 
Notes
Provide a valid email for the assignee of the ticket.
Example
Jane.Doe@example-prismatic.io
Input
Assignee Id
string
Default
 
Notes
Provide a valid user id for the assignee of the ticket.
Example
403598029853443232
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
Requester Organization Id
string
Default
 
Notes
Provide an integer value to specify the Organization of the requester.
Example
488042375842
Input
Tags
string
Value List
Default
 
Notes
For each item, provide a string value for the tag.
Example
Engineering
Input
Ticket Comment Body
string
Default
 
Notes
When creating a ticket, this field can be used to give a ticket description. It will also leave a comment on the ticket from the assignee.
Example
This is an example Comment.
Input
Ticket Comment HTML Body
string
Default
 
Notes
When creating a ticket, this field can be used to give a ticket description using HTML. It will also leave a comment on the ticket from the assignee.
Example
<p>This is an example Comment.</p>
Input
Ticket Id
string
/ Required
Default
 
Notes
Provide the unique identifier for the ticket you would like to show.
Example
ExampleTicketId
Input
Ticket Priority
string
Default
 
Notes
Provide a string value for the priority of the ticket.
Example
 
Input
Ticket Status
string
Default
 
Notes
Provide a string value for the status of the ticket.
Example
 
Input
Ticket Subject
string
Default
 
Notes
Provide a string value for the subject of the ticket
Example
This is an example ticket subject.
Input
Ticket Type
string
Default
 
Notes
Provide a string value for the type of the ticket.
Example
 
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

Update User#

Update the information and metadata of a user by Id | key: updateUser

InputDefaultNotesExample
Input
Debug
boolean
Default
false
Notes
This flag toggles debugging. When true the integration will log any requests and failures.
Example
 
Input
Moderator
boolean
Default
 
Notes
This flag specifies whether or not the user will have moderator permissions.
Example
 
Input
Verified
boolean
Default
 
Notes
Flip this flag to true if any of the user's identities is verified.
Example
 
Input
Organization Id
string
Default
 
Notes
Provide the unique identifier of the organization.
Example
 
Input
Alias
string
Default
 
Notes
Provide a string value that represents an alias to give to a user.
Example
Example Alias
Input
Details
string
Default
 
Notes
Provide a string value that represents details to be attached to the user.
Example
These are some example user details
Input
Email Address
string
Default
 
Notes
Provide a valid email address for the user. Make sure this value does not conflict with any other users in your Zendesk Domain
Example
someone@example-prismatic.io
Input
UserId
string
/ Required
Default
 
Notes
Provide an integer value for the unique identifier of the user.
Example
488042375842
Input
Name
string
Default
 
Notes
Provide a string value for the name of the user.
Example
John Doe
Input
Notes
string
Default
 
Notes
Provide a string value that represents notes to be attached to the user.
Example
These are some example notes.
Input
Phone Number
string
Default
 
Notes
Provide a valid phone number for the user.
Example
15554008989
Input
User Role
string
Default
 
Notes
Provide which level of permissions the user is granted.
Example
 
Input
Time Zone
string
Default
 
Notes
Provide a valid timezone that the user operates in.
Example
Berlin
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 

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