https://github.com/blakmatrix/node-zendesk
A trusted Zendesk API client library for Node.js and the browser, lovingly maintained for over 10 years.
https://github.com/blakmatrix/node-zendesk
api api-client browser-library buddha customer-service customer-support javascript knowledge-base node-zendesk promises support supportdesk wrapper zendesk zendesk-api zendesk-apps
Last synced: 4 months ago
JSON representation
A trusted Zendesk API client library for Node.js and the browser, lovingly maintained for over 10 years.
- Host: GitHub
- URL: https://github.com/blakmatrix/node-zendesk
- Owner: blakmatrix
- License: mit
- Created: 2012-06-27T02:16:27.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2025-09-29T08:30:15.000Z (4 months ago)
- Last Synced: 2025-10-08T05:43:53.998Z (4 months ago)
- Topics: api, api-client, browser-library, buddha, customer-service, customer-support, javascript, knowledge-base, node-zendesk, promises, support, supportdesk, wrapper, zendesk, zendesk-api, zendesk-apps
- Language: JavaScript
- Homepage: https://blakmatrix.github.io/node-zendesk/
- Size: 1.65 MB
- Stars: 369
- Watchers: 23
- Forks: 237
- Open Issues: 12
-
Metadata Files:
- Readme: ReadMe.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://blakmatrix.github.io/node-zendesk/)
[![npm][npm]][npm-url]
[![node][node]][node-url]
[![licenses][licenses]][licenses-url]
[![PR's welcome][prs]][prs-url]
[![XO code style][xo]][xo-url]
node-zendesk
A Zendesk API client library for use with node.js
node-zendesk is a versatile gateway between Node.js and the Zendesk Customer Support Platform. Primarily designed for seamless integration with Node.js applications, it also excels in transforming, accessing, and packaging various Zendesk resources and assets. Beyond its core function, it stands ready to bridge the gap between development and Zendesk's powerful capabilities.
**Read the full documentation at [blakmatrix.github.io/node-zendesk/](https://blakmatrix.github.io/node-zendesk/)**
## Install
To use the API, just do the standard
```shell
npm install --save node-zendesk
```
## Example
```js
var zendesk = require('node-zendesk');
// or `import {createClient} from 'node-zendesk'` if using typescript
var client = zendesk.createClient({
username: 'username',
token: 'token',
subdomain: 'subdomain'
});
client.users.list().then(users => {
console.log('Total Users:', users.length);
console.log('User Names:', users.map(user => user.name));
}).catch(error => {
console.error(`Failed to get list of users: ${error.message}`);
});
```
Take a look in the `examples` folder for more examples.
## Getting Started
If you're new to `node-zendesk`, we recommend checking out our [Getting Started Guide](https://blakmatrix.github.io/node-zendesk/guide) to help you set up and familiarize yourself with the library.
## Contributions
If you're looking to contribute, please refer to the [API Coverage Document](https://github.com/blakmatrix/node-zendesk/blob/master/doc/api-coverage.md), open an issue, or make a PR!
Tests and examples are also welcome.
Zendesk's documentation can be found [here](https://developer.zendesk.com/documentation/).
## 🌟 Support Our Project!
🎉 Join our community of supporters, backers, and sponsors to help fuel the growth and sustainability of our open-source project. Your contribution, no matter the size, makes a meaningful impact:
- **Supporters ($1/month):** Even a small contribution helps us continue our mission. Every dollar adds up!
- **Backers ($5/month):** Take your support up a notch and gain exclusive updates and features.
- **Sponsors ($100/month):** Champion the project's progress, get prominent recognition, and shape its future.
By becoming a supporter, backer, or sponsor, you're investing in the innovation and excellence of our project. Together, we can drive meaningful change and empower developers worldwide.
🚀 [Join Us](https://opencollective.com/node-zendesk) | [Learn More](https://opencollective.com/node-zendesk)
## License
MIT.
[npm]: https://img.shields.io/npm/v/node-zendesk.svg
[npm-url]: https://npmjs.com/package/node-zendesk
[node]: https://img.shields.io/node/v/node-zendesk.svg
[node-url]: https://nodejs.org
[prs]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg
[prs-url]: https://github.com/blakmatrix/node-zendesk/blob/master/CONTRIBUTING.md
[licenses-url]: https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fblakmatrix%2Fnode-zendesk?ref=badge_shield
[licenses]: https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fblakmatrix%2Fnode-zendesk.svg?type=shield
[xo]: https://shields.io/badge/code_style-5ed9c7?logo=xo&labelColor=gray
[xo-url]: https://github.com/xojs/xo