Zenpy

Zenpy is a Python wrapper for the Zendesk API. The goal of the project is to make it possible to write clean, fast, Pythonic code when interacting with Zendesk progmatically. The wrapper tries to keep API calls to a minimum. Wherever it makes sense objects are cached, and attributes of objects that would trigger an API call are evaluated lazily.

The wrapper supports both reading and writing from the API.

Zenpy supports both Python2 and Python3.

Please report bugs!

• Quickstart
• Examples * Commenting on a ticket * Uploading an attachment * Creating a ticket with a custom field set * Updating a custom field on a ticket
• Documentation
• Contributions

Quickstart

# Create a Zenpy object
zenpy = Zenpy(**credentials)

# Create a new ticket
zenpy.tickets.create(Ticket(subject="Important", description="Thing"))

# Perform a simple search
for ticket in zenpy.search("party", type='ticket', assignee="face"):
    print(ticket)

Examples

Commenting on a ticket

from zenpy.lib.api_objects import Comment

ticket = zenpy.tickets(id=some_ticket_id)
ticket.comment = Comment(body="Important private comment", public=False)
zenpy.tickets.update(ticket)

Uploading an attachment

from zenpy.lib.api_objects import Comment

# Upload the file to Zendesk and obtain a Upload object
upload_object = zenpy.attachments.upload('/tmp/awesome_file.txt')

ticket = zenpy.tickets(id=some_ticket_id)
ticket.comment = Comment(body='This comment has my file attached', uploads=[upload_object.token])
zenpy.tickets.update(ticket)

Creating a ticket with a custom field set

from zenpy.lib.api_objects import CustomField, Ticket

ticket_audit = zenpy.tickets.create(Ticket(
    subject='Has custom field',
    description="Wow, such field",
    custom_fields=[CustomField(id=43528467, value=1337)]
))

Updating a custom field on a ticket

from zenpy.lib.api_objects import CustomField
ticket = zenpy.tickets(id=some_ticket_id)
ticket.custom_fields.append(CustomField(id=43528467, value=1337))
zenpy.tickets.update(ticket)

Documentation

Check out the documentation for more info.

Contributions

Contributions are very welcome.