WorkOS PHP Library for Laravel

v1.5.0 2022-04-13 18:16 UTC


The WorkOS library for Laravel provides convenient access to the WorkOS API from applications written in Laravel.


See the API Reference for Laravel usage examples.


To install via composer, run the following:

composer require workos/workos-php-laravel

For Laravel 5.0-5.4, add the WorkOS ServiceProvider in your config/app.php:

"providers" => array(
    // ...

For Laravel 5.5 and up, 6.x and 7.x... you're all set!


Create a WorkOS configuration file by running the following:

php artisan vendor:publish --provider="WorkOS\Laravel\WorkOSServiceProvider"

The package will need to be configured with your api key and project id. By default, the package will look for a WORKOS_API_KEY and WORKOS_CLIENT_ID environment variable.

SDK Versioning

For our SDKs WorkOS follows a Semantic Versioning (SemVer) process where all releases will have a version X.Y.Z (like 1.0.0) pattern wherein Z would be a bug fix (e.g., 1.0.1), Y would be a minor release (1.1.0) and X would be a major release (2.0.0). We permit any breaking changes to only be released in major versions and strongly recommend reading changelogs before making any major version upgrades.

More Information