zendesk-node-api

Zendesk NodeJS API

A wrapper library for Zendesk using NodeJS

• Tickets
• Ticket Fields
• Users

Getting started

Install the package via npm

$ npm install zendesk-node-api

Create a new instance of Zendesk, passing in your Zendesk URL, email and API token.

var Zendesk = require('zendesk-node-api');

var zendesk = new Zendesk({
  url: YOUR_ZENDESK_URL, // https://example.zendesk.com
  email: YOUR_ZENDESK_EMAIL, // [e-mail]
  token: YOUR_ZENDESK_API_TOKEN // hfkUny3vgHCcV3UfuqMFZWDrLKms4z3W2f6ftjPT
});

Tickets

These methods allow you to interact with tickets within Zendesk

List tickets

Returns a promise containing an array of all tickets in your Zendesk

zendesk.tickets.list().then(function(tickets){
  // Do something with tickets
});

Show a ticket

Returns a promise containing an object of a specific ticket

zendesk.tickets.show(TICKET_ID).then(function(ticket){
  // Do something with ticket
});

Create a ticket

Create a ticket inside Zendesk

zendesk.tickets.create({
  subject: 'A new ticket',
  comment: {
      body: 'A ticket created with zendesk-node-api'
  }
}).then(function(){
  console.log('Ticket created');
});

Update a ticket

Update a ticket inside Zendesk

zendesk.tickets.update(TICKET_ID, {
  comment: {
    body: 'Updated this ticket with zendesk-node-api'
  }
}).then(function(){
  console.log('Ticket updated');
});

Delete a ticket

Delete a ticket inside Zendesk

zendesk.tickets.delete(TICKET_ID).then(function(){
  console.log('Ticket deleted');
});

Ticket Fields

These methods allow you to interact with ticket fields within Zendesk

List ticket fields

Returns a promise containing an array of all ticket fields in your Zendesk

zendesk.ticketFields.list().then(function(ticketFields){
  // Do something with ticketFields
});

Show a ticket field

Returns a promise containing an object of a specific ticket field

zendesk.ticketFields.show(TICKET_FIELD_ID).then(function(ticketField){
  // Do something with ticketField
});

Create a ticket field

Create a ticket field inside Zendesk

zendesk.ticketFields.create({
  type: 'text',
  title: 'Title for the Ticket Field'
}).then(function(){
  console.log('Ticket field created!');
});

Update a ticket field

Update a ticket field inside Zendesk

zendesk.ticketFields.update(TICKET_FIELD_ID, {
  type: 'text',
  title: 'Updated Ticket Field Title'
}).then(function(){
  console.log('Ticket field updated!');
});

Delete a ticket field

Delete a ticket field inside Zendesk

zendesk.ticketFields.delete(TICKET_FIELD_ID).then(function(){
  console.log('Ticket field deleted');
});

Users

These methods allow you to interact with users within Zendesk

List Users

Returns a promise containing an array of all users in your Zendesk

zendesk.users.list().then(function(users){
  // Do something with users
});

Show a user

Returns a promise containing an object of a specific user

zendesk.users.show(USER_ID).then(function(user){
  // Do something with user
});

Create a user

Create a user inside Zendesk

zendesk.users.create({
  name: 'API User',
  email: '[e-mail]'
}).then(function(){
  console.log('User created');
});

Update a user

Update a user inside Zendesk

zendesk.users.update(USER_ID, {
  email: '[e-mail]'
}).then(function(){
  console.log('User updated');
});

Delete a user

Delete a user inside Zendesk

zendesk.users.delete(USER_ID).then(function(){
  console.log('User deleted');
});