NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1245 most downloaded on Packagist
Intercom API client.
Latest stable
6.0.0
Last release 17 days ago
05 Nov 2026
Ships unpredictably
gaps range from 2 weeks to 2.7 years
Most releases are documented
notes for 35 of 46 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
58 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>
Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Allow psr/http-message v2 by @FlashBlack in https://github.com/intercom/intercom-php/pull/364
IntercomClient::$password explicitly nullable by @hhamon in https://github.com/intercom/intercom-php/pull/373Full Changelog: https://github.com/intercom/intercom-php/compare/v4.5.0...v4.5.1
HTTP: add support for PSR17/PSR18 and drop usage of deprecated client discovery by @glaubinix in https://github.com/intercom/intercom-php/pull/363
Fix double handleResponse() bug for nextCursorPage
Fixed a bug in nextSearchPage. This method was wrongfully processing the response twice, which could lead to exceptions depending on the PHP configura
Fixed a bug in nextSearchPage. This method was wrongfully processing the response twice, which could lead to exceptions depending on the PHP configuration.
The previous release introduced support for the Contacts API. However, the contact update method wasn't working because it was missing the contact id
The previous release introduced support for the Contacts API. However, the contact update method wasn't working because it was missing the contact id in the URL. This release fixes the $client->contacts->update method.
This release includes the following:
This release includes the following:
This release adds support for Teams:
This release adds support for Teams:
$intercomClient->teams->getTeams()$intercomClient->teams->getTeam($id)This release adds support for listing users of a company via $intercomClient->companies->getCompanyUsers($id)
This release adds support for listing users of a company via $intercomClient->companies->getCompanyUsers($id)
This release reduces the size of the sdk by excluding unnecessary files from the package (tests, test configurations, CI configuration, etc).
This release reduces the size of the sdk by excluding unnecessary files from the package (tests, test configurations, CI configuration, etc).
This is a minor patch that adds type hinting to constructors and some other methods for enhanced security and enhanced compatibility with the Symfony4
This is a minor patch that adds type hinting to constructors and some other methods for enhanced security and enhanced compatibility with the Symfony4 autowiring features. See https://github.com/intercom/intercom-php/issues/282 for more details.
None of the methods where type hinting was added would have worked if the incorrect types were passed through, so this change is fully backwards compatible.
This release enables the usage of the new customer search endpoint.
This release enables the usage of the new customer search endpoint.
At the moment of writing, this is only available in the Unstable version. Please see the API Changelog and the notes about API Versions for intercom-php.
This release adds compatibility with php-http/client-common version 2, which also allows this library to be used with HTTPlug 2.
This release adds compatibility with php-http/client-common version 2, which also allows this library to be used with HTTPlug 2.
https://github.com/intercom/intercom-php/pull/274 fixes two variables with incorrect names, which might lead to some warnings or errors, for example,
https://github.com/intercom/intercom-php/pull/274 fixes two variables with incorrect names, which might lead to some warnings or errors, for example, if PHP strict mode is enabled.
#272 After the previous upgrade we discovered that no errors were being thrown. To address this we used ErrorPlugin to raise 4xx and 5xx exceptions
#272 After the previous upgrade we discovered that no errors were being thrown. To address this we used ErrorPlugin to raise 4xx and 5xx exceptions
Upgrade to PHP 7.1+ #271 PHP 5.6 and 7.0 are no longer supported. We should only support active versions (7.1, 7.2 and 7.3 at the time of writing)
Upgrade to PHP 7.1+ #271 PHP 5.6 and 7.0 are no longer supported. We should only support active versions (7.1, 7.2 and 7.3 at the time of writing)
Abstract the HTTP client using HTTPPlug #270
This version introduces HTTPPlug as the HTTP Client. HTTPPlug allows this library to use any HTTP Library as long as there is a HTTPPlug adaptor for it. All major libraries are available (Guzzle5/6, CURL, Buzz and many more).
Upgrade instructions:
- Check if any change from the list below affects your code and update it if required.
- Choose a client implementation and include it to your dependencies (ie
composer require php-http/curl-client). We recommend that you choose the adapter for the library you already use in your project. If you don't use any,php-http/curl-clientis the most lightweight.- Upgrade your
intercom/intercom-phpdependency:composer update intercom/intercom-php.Changes in this version:
IntercomClientconstructor third parameter now only accepts a key-value array of request headers, that will be included in every request, eg:new IntercomClient('token', null, ['Custom-Header' => 'value']);. If you were passing any other options to the client (apart from headers), you will need to instantiate your own client and pass it using thesetHttpClientmethod. Example:$httpClient = new Http\Adapter\Guzzle6\Client( new GuzzleHttp\Client(['connect_timeout' => 5]); ); $client = new IntercomClient('token'); $client->setHttpClient($httpClient);
IntercomClientmethodsetClienthas been renamed tosetHttpClient. Its first argument must be aPsr\Http\Client\ClientInterface. If you were using this method before upgrading, you can use the Guzzle6 adapter like in the example above. For example,$client->setClient($guzzleClient)would need to be changed to$client->setHttpClient(new Http\Adapter\Guzzle6\Client($guzzleClient)).
IntercomClientno longer exposes the methodsgetGuzzleRequestOptionsandgetAuth.
IntercomClientnow provides the methodssetRequestFactoryandsetUriFactoryso you can customize the generation of requests and URIs if needed.From now on, all the exceptions thrown by the SDK will implement
Http\Client\Exception. See the different exceptions that can be thrown in the HTTPPlug documentation
it also introduces an archive function to enable soft delete of users (previously delete)
#251 introduces the ability to permanently delete a user
More PSR2 fixes #236 Added scroll for leads #238
More PSR2 fixes #236 Added scroll for leads #238
This is related to PR #233 by @kmossco and #218 to refactor the code for PSR2 styling
This is related to PR #233 by @kmossco and #218 to refactor the code for PSR2 styling
Related to #205 added option to set Guzzle requests if needed. Also, includes fix to remove use of 'function' keyword for compatibility with symfony 2
Related to #205 added option to set Guzzle requests if needed. Also, includes fix to remove use of 'function' keyword for compatibility with symfony 2.7 and fix issue with rate limit header unit test failing
This allows users to access rate limit info contained in the rate limit headers in the response.
This allows users to access rate limit info contained in the rate limit headers in the response.
Updating for new view segment option
Updating for new view segment option
Nothing published for this version
Several fixes to phpdocs, contributed by @fnwbr @andrewandante
Several fixes to phpdocs, contributed by @fnwbr @andrewandante
Nothing published for this version
Nothing published for this version
Add PhpDoc to methods and variables Add a new method to IntercomUsers to allow fetching details of a single user by its Intercom id
Add PhpDoc to methods and variables Add a new method to IntercomUsers to allow fetching details of a single user by its Intercom id
Add method for deleting a user
Add method for deleting a user
Requires php 5.6 (which is why we are using a major version)
Major rewrite using recent Guzzle
Major rewrite using recent Guzzle
Adds created_since when listing users
Adds created_since when listing users
Adds order when listing users
Adds order when listing users
Adds bulk support for both users and events.
1.3.2
This release fixes an issue with paging
This release fixes an issue with paging
Adds support for the Bulk API (Users)
Adds support for the Bulk API (Users)
Nothing published for this version
Nothing published for this version
Nothing published for this version
v1.2.0 Supports assigning, opening, and closing conversations.
v1.2.0 Supports assigning, opening, and closing conversations.
Fix encoding for empty event metadata
Version 1.1.0 supports the Acquire package
Version 1.1.0 supports the Acquire package
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add a user-agent string to the default headers
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.