---
id: zenpy
version: "2.0.57"
license: GPLv3
license_treatment: copyleft
maintenance: active
---

# zenpy — Python wrapper for the Zendesk API

License: copyleft · Maintenance: active · Downloads: 4.6M/mo

## What it is and what it does

Zenpy is a Python client library that wraps the Zendesk, Chat, and HelpCentre REST APIs, abstracting away HTTP details and providing Pythonic object-oriented access to tickets, users, help center articles, and other Zendesk resources. It depends on requests for HTTP transport, python-dateutil and pytz for timezone-aware date handling, cachetools for object caching, and six for Python 2/3 compatibility.

The library is designed to reduce boilerplate and API call overhead by automatically caching objects and deferring attribute access until needed. You instantiate a client with your Zendesk credentials, then interact with resources through method calls that return Python objects—tickets, users, comments, attachments—which can be serialized to dict or JSON. It supports common workflows like creating and updating tickets, searching, managing custom fields, uploading attachments, and working with help center content.

Use it for:

- Automate ticket creation and updates in bulk from external systems or scheduled jobs.
- Build support dashboards or reporting tools that query Zendesk ticket data without manual API pagination.
- Integrate Zendesk ticketing into internal workflows, such as syncing issues from a bug tracker to support tickets.
- Manage help center content programmatically—create articles, sections, and categories from templates or external sources.
- Implement custom ticket search and filtering logic with Python rather than Zendesk's query language.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Zenpy is a Python wrapper for the Zendesk, Chat, and HelpCentre APIs that simplifies programmatic interaction with Zendesk by caching objects and lazily evaluating attributes to minimize API calls.

Yes, with license review. Zenpy is actively maintained, has low install friction, no known vulnerabilities, and is well-suited for Zendesk automation and integration work. However, its GPLv3 copyleft license is a hard constraint—only use it if your project is compatible with GPLv3 or if you can isolate it behind a service boundary. If your project is proprietary or under a permissive license, this package is not an option.

## Install

pip install zenpy
uv add zenpy
poetry add zenpy

## Installing zenpy

Before you install: Low install friction with a pure-wheel distribution and five common runtime dependencies (requests, python-dateutil, cachetools, pytz, six). The package is actively maintained with a recent commit on 2026-08-05 and has been in development since 2015-08-30.

License in practice: Zenpy is licensed under GPLv3 (copyleft), which requires that any derivative work or distribution must also be released under GPLv3. This is a strong copyleft obligation—review your project's license compatibility before integrating.

Quickstart:

from zenpy import Zenpy
from zenpy.lib.api_objects import Ticket

zenpy_client = Zenpy(**credentials)
zenpy_client.tickets.create(Ticket(subject="Important", description="Thing"))

for ticket in zenpy_client.search('query', type='ticket', assignee='user'):
    print(ticket.requester.name)

Requires valid Zendesk API credentials passed as keyword arguments to the Zenpy constructor.

Verify before relying:

- Whether the package still actively supports Python 2.7 as listed in classifiers, or if Python 3 is now required.
- Current state of support for Chat and HelpCentre APIs relative to the Zendesk API's evolution since the last release.

## Package facts

- License: GPLv3 (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 4.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zendesk api wrapper, zendesk python client, ticket management api, zendesk automation, help center api python, zendesk integration library, support ticket api, zendesk-integration, api-wrapper, copyleft-license

[View on SkillFed](https://skillfed.io/packages/zenpy) · [View on PyPI](https://pypi.org/project/zenpy/)