Skip to content
Official Zendesk API v2 client library for PHP
PHP Hack
Branch: master
Clone or download
Pull request Compare This branch is even with zendesk:master.
Latest commit 8a2f448 Dec 2, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin transferred Console related classes on a more appropriate folder Oct 3, 2017
samples adding dropdown ticket field examples Apr 17, 2018
tests Talk Stats Endpoint Mar 16, 2018
.gitignore Commit composer.lock Jun 2, 2015
.travis.yml Use trusty to run tests for php 5.5 Oct 11, 2019 separate contributing guide Jul 23, 2016 Updating Getting All Tickets for a User Sep 4, 2018
VERSION bump version to 2.2.9 Jun 28, 2019
composer.json bump to v2.2.7 remove flowdock hook Jan 30, 2018
composer.lock upgrade phpmd Dec 2, 2019
index.php Updating Sample Index Apr 20, 2018
phpunit.xml.dist Remove secrets and tokens from repo Jun 14, 2019

Zendesk PHP API Client Library

Build Status Latest Stable Version Total Downloads Code Climate License

API Client Version

This is the second version of our PHP API client. The previous version of the API client can be found on the v1 branch.

API version support

This client only supports Zendesk's API v2. Please see our API documentation for more information.


  • PHP 5.5+


The Zendesk PHP API client can be installed using Composer.


To install run composer require zendesk/zendesk_api_client_php

Upgrading from V1 to V2

If you are upgrading from v1 of the client, we've written an upgrade guide to highlight some of the key differences.


Configuration is done through an instance of Zendesk\API\HttpClient. The block is mandatory and if not passed, an error will be thrown.

// load Composer
require 'vendor/autoload.php';

use Zendesk\API\HttpClient as ZendeskAPI;

$subdomain = "subdomain";
$username  = ""; // replace this with your registered email
$token     = "6wiIBWbGkBMo1mRDMuVwkw1EPsNkeUj95PIz2akv"; // replace this with your token

$client = new ZendeskAPI($subdomain);
$client->setAuth('basic', ['username' => $username, 'token' => $token]);


Basic Operations

// Get all tickets
$tickets = $client->tickets()->findAll();

// Get all tickets regarding a specific user.
$tickets = $client->users($requesterId)->tickets()->requested();

// Create a new ticket
$newTicket = $client->tickets()->create([
    'subject'  => 'The quick brown fox jumps over the lazy dog',
    'comment'  => [
        'body' => 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, ' .
                  'sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'
    'priority' => 'normal'

// Update a ticket
    'priority' => 'high'

// Delete a ticket

// Get all users
$users = $client->users()->findAll();


$attachment = $client->attachments()->upload([
    'file' => getcwd().'/tests/assets/UK.png',
    'type' => 'image/png',
    'name' => 'UK.png' // Optional parameter, will default to filename.ext

Attaching files to comments

$ticket = $client->tickets()->create([          
    'subject' => 'The quick brown fox jumps over the lazy dog',      
    'comment' => [                              
        'body' => 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, ' .
                  'sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.', 
        'uploads'   => [$attachment->upload->token]                 


Side-loading allows you to retrieve related records as part of a single request. See [the documentation] for more information. (

An example of sideloading with the client is shown below.

$tickets = $client->tickets()->sideload(['users', 'groups'])->findAll();


The Zendesk API offers a way to get the next pages for the requests and is documented in the Zendesk Developer Documentation.

The way to do this is to pass it as an option to your request.

$tickets = $this->client->tickets()->findAll(['per_page' => 10, 'page' => 2]);

The allowed options are

  • per_page
  • page
  • sort_order

Retrying Requests

Add the RetryHandler middleware on the HandlerStack of your GuzzleHttp\Client instance. By default Zendesk\Api\HttpClient retries:

  • timeout requests
  • those that throw Psr\Http\Message\RequestInterface\ConnectException:class
  • and those that throw Psr\Http\Message\RequestInterface\RequestException:class that are identified as ssl issue.

Available options

Options are passed on RetryHandler as an array of values.

  • max = 2 limit of retries
  • interval = 300 base delay between retries in milliseconds
  • max_interval = 20000 maximum delay value
  • backoff_factor = 1 backoff factor
  • exceptions = [ConnectException::class] Exceptions to retry without checking retry_if
  • retry_if = null callable function that can decide whether to retry the request or not


Pull Requests are always welcome but before you send one please read our contribution guidelines. It would speed up the process and would make sure that everybody follows the community's standard.


To help would be contributors, we've added a REPL tool. It is a simple wrapper for psysh and symfony's console. On your terminal, run bin/console <subdomain> <email> <api token>. This would automatically create an instance of Zendesk\API\HttpClient on $client variable. After that you would be able to enter any valid php statement. The goal of the tool is to speed up the process in which developers can experiment on the code base.

Copyright and license

Copyright 2013-present Zendesk

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.