janhenkes / teamleader-php-sdk
Teamleader API v2 PHP SDK
Installs: 7 690
Dependents: 1
Suggesters: 0
Security: 0
Stars: 17
Watchers: 6
Forks: 25
Open Issues: 3
Requires
- php: ^8.0
- guzzlehttp/guzzle: ^6.0|^7.0
Requires (Dev)
- phpunit/phpunit: ^9.5.9
README
This is a PHP wrapper for the Teamleader API v2. Documentation of the API can be found here: https://developer.focus.teamleader.eu/. Please note that the Teamleader API v2 is not complete and some Entities and Actions are missing.
Currently we support these entities and per entity only a few actions:
- Company (create and update, getById)
- Contact (create, update, linkToCompany, getById)
- Deal (create, update, move, get, getById)
- Deal phases (get)
- Deal sources (get)
- Activity types (get)
- Event (create, update, delete, get, getById)
- Business types (get)
- Tags (get)
- Invoice (get, book, registerPayment, download, file)
- Credit notes (get)
- Payment terms (get)
- Tax rates (get)
- Withholding tax rates (get)
- Departments (get)
- User (me, get, getById)
- Webhook (get, register)
- Projects (get, getById)
- Tasks (get, getById)
- Milestones (get, getById)
- TimeTracking (get, getById)
- Worktypes (get)
- Productcategories (get)
- Products (create, get, getById)
- Custom fields (get)
- Quotations (get, getById, download, file)
Teamleader API v2 works with OAuth2. This means your application needs to be registered on the Teamleader Marketplace (you can keep them private though).
Please contact me at jan@jannesmannes.nl if you have any feedback or questions.
Support us
You can support us by making a donation.
We appreciate you sending us a postcard from your hometown. You'll find our address on our contact page (inspired by @spatie).
Examples
See all examples in the examples directory.
Request an access token
You need to do this once, after you get an access token you can use the refresh token to obtain a new access token after it expires.
<?php
require __DIR__ . '/../vendor/autoload.php';
require __DIR__ . '/credentials.php';
$redirectUrl = 'https://teamleader-php-sdk.dev/examples/acquire-access-token.php';
$connection = new \Teamleader\Connection();
$connection->setClientId( $clientId );
$connection->setClientSecret( $clientSecret );
$connection->setRedirectUrl( $redirectUrl );
$connection->acquireAccessToken();
Create a company
$company = $client->company( [
'name' => 'Test API v2',
] )->save();
Get deal phases
$dealPhases = $client->dealPhase()->get();
Change log
2.9.3 (2021-12-21)
- Fixed Guzzle 7 support
2.9.2 (2021-11-23)
- Set API version
2.9.1 (2021-11-22)
- Updated Guzzle dependency
2.9.0 (2021-09-23)
- Changed base URL to focus.teamleader.eu
- Updated entity fields
2.8.0 (2021-02-18)
- Improved default cache handler
2.7.1 (2021-01-12)
- Added custom fields to Project entity
2.7.0 (2020-11-11)
- Find invoice by id
2.6.0 (2020-09-25)
Cheers to @rQwk
- Added Quotations endpoint
2.5.1 (2020-06-29)
- Updated fillables for Invoice entity
2.5.0 (2020-06-22)
Thanks to @kjellknapen
Features:
- Added invoice download and file actions
2.4.0 (2020-06-08)
Thanks to @jurrienpiris
Features:
- Added summary to fillable attributes of the Deal entity
2.3.0 (2020-03-15)
Thanks to @marzsman
Features:
- Get custom fields
2.2.0 (2020-03-04)
Credits for this release go to @kjellknapen and @PazkaL
Features:
- Book invoices and register payments
- Get product categories
- Get products
2.1.0 (2020-03-03)
Credits for this release go to @cschalenborgh
Features:
- Get deals improvements
- Get projects
- Get tasks
- Get milestones
- Get time tracking
- Get work types
2.0.0 (2019-09-24)
Many thanks to @Senjutsuu and @carakas from @sumocoders for most of the below changes!
Features:
- Move deals
- List and register webhooks
- Added repo license
- Added old id to new id migration endpoint
- Moved to PHP 7.1
- Activity type entity added
- Event entity added
- Added a remove endpoint to all storable entities
- Added businesstype entity
- Added tag entity
- Added invoice entity
- Added credit note entity
- Added tax rate entity
- Added payment term entity
- Added withholding tax rate entity
- Added department entity
- Added unit tests
- A lot of code refactoring
- Added filter, paging en sorting attributes to entities
- Added JSON serialisation
- Added fetchAll method to entities
- Added user entity
Fixes:
- Updated outdated attributes for the company entity
- Fix getting data from the cache when there is no cached data
- Storable::update fixed
1.2.0 (2018-08-23)
Features:
- Added Contact->linkToCompany Action
1.1.1 (2018-08-23)
Features:
- Added readme
Fixes:
- Switched back to GuzzleHttp 6
1.1.0 (2018-08-22)
Features:
- Added more examples
- Implemented FindAll action
- Added DealPhase entity
- Added DealSource entity