Beta Versions
Certain WorkOS features may be available only in the beta version of the SDK. Beta versions have the-beta.* suffix, for example,
3.2.0-beta.1. For more information on how to use beta
versions, refer to the README in the GitHub repository.
Releases
June 22, 2026
v8.0.0
Latest June 22, 2026
v7.0.1...v8.0.0" rel="noreferrer" target="_blank">8.0.0 (2026-06-22)
⚠ BREAKING CHANGES
- require workos-php v7 (https://github.com/workos/workos-php-laravel/issues/103" rel="noreferrer" target="_blank">#103)
- drop Laravel 11 support (https://github.com/workos/workos-php-laravel/issues/104" rel="noreferrer" target="_blank">#104)
Features
- drop Laravel 11 support (https://github.com/workos/workos-php-laravel/issues/104" rel="noreferrer" target="_blank">#104) (https://github.com/workos/workos-php-laravel/commit/13e0b5af56a45690597440330f7684604857a010" rel="noreferrer" target="_blank">13e0b5a)
- require workos-php v7 (https://github.com/workos/workos-php-laravel/issues/103" rel="noreferrer" target="_blank">#103) (https://github.com/workos/workos-php-laravel/commit/51b8823442c0fd0f3c426de987b8034e63b4e158" rel="noreferrer" target="_blank">51b8823)
June 17, 2026
v7.0.1
June 17, 2026
v7.0.0...v7.0.1" rel="noreferrer" target="_blank">7.0.1 (2026-06-17)
Bug Fixes
- renovate: explicitly enable minor and patch updates (https://github.com/workos/workos-php-laravel/issues/99" rel="noreferrer" target="_blank">#99) (https://github.com/workos/workos-php-laravel/commit/4d2c92340e95dbe4e4362f780695277b39a84a7d" rel="noreferrer" target="_blank">4d2c923)
Miscellaneous Chores
- deps: update github actions non-major (https://github.com/workos/workos-php-laravel/issues/101" rel="noreferrer" target="_blank">#101) (https://github.com/workos/workos-php-laravel/commit/0672dad789a40cf09aa8ac97ed06e3e012266f58" rel="noreferrer" target="_blank">0672dad)
May 18, 2026
v7.0.0
May 18, 2026
v6.0.0...v7.0.0" rel="noreferrer" target="_blank">7.0.0 (2026-05-18)
⚠ BREAKING CHANGES
- deps: update dependency workos/workos-php to v6 (https://github.com/workos/workos-php-laravel/issues/98" rel="noreferrer" target="_blank">#98)
Features
- deps: update dependency workos/workos-php to v6 (https://github.com/workos/workos-php-laravel/issues/98" rel="noreferrer" target="_blank">#98) (https://github.com/workos/workos-php-laravel/commit/a0c710d420cb184682fbbad75dc7b5a22bd98bb0" rel="noreferrer" target="_blank">a0c710d)
Bug Fixes
- Remove extractVersion from matchUpdateTypes rules (https://github.com/workos/workos-php-laravel/issues/95" rel="noreferrer" target="_blank">#95) (https://github.com/workos/workos-php-laravel/commit/665f3c4b54e9f5f359836f206e2081c10d0eaf6d" rel="noreferrer" target="_blank">665f3c4)
Miscellaneous Chores
- deps: update googleapis/release-please-action action to v5 (https://github.com/workos/workos-php-laravel/issues/97" rel="noreferrer" target="_blank">#97) (https://github.com/workos/workos-php-laravel/commit/1edeffcdeecba5d8031d60cdaf7ed00aab528eb7" rel="noreferrer" target="_blank">1edeffc)
- deps: update minor and patch updates (https://github.com/workos/workos-php-laravel/issues/91" rel="noreferrer" target="_blank">#91) (https://github.com/workos/workos-php-laravel/commit/bea62b5cc1b4961c3cb9c46e9a32241c418cd940" rel="noreferrer" target="_blank">bea62b5)
- deps: update shivammathur/setup-php action to v2.37.0 (https://github.com/workos/workos-php-laravel/issues/96" rel="noreferrer" target="_blank">#96) (https://github.com/workos/workos-php-laravel/commit/e4dbbeceb1d566364c65d680443b401a5a77c76a" rel="noreferrer" target="_blank">e4dbbec)
- do not include whole name (https://github.com/workos/workos-php-laravel/commit/7678389d73f5b7d4b291dd20b8409acf757a11b3" rel="noreferrer" target="_blank">7678389)
- use shared workos/renovate-config preset (https://github.com/workos/workos-php-laravel/commit/d4eb45750a26d27f9f10c6c34725a98353b22882" rel="noreferrer" target="_blank">d4eb457)
April 14, 2026
v6.0.0
April 14, 2026
workos/workos-php-laravel-v5.1.0...workos/workos-php-laravel-v6.0.0" rel="noreferrer" target="_blank">6.0.0 (2026-04-14)
⚠ BREAKING CHANGES
- v6 is a major rewrite of the Laravel SDK to align with the redesigned
workos/workos-phpv5 client. WorkOS\Laravel\Services\WorkOSServicehas been removed. The container, helper, and facade now resolve to\WorkOS\WorkOSdirectly.- Several service accessors were renamed upstream:
mfa()→multiFactorAuth(),portal()→adminPortal(),rbac()→authorization(), andwebhook()was split intowebhooks()andwebhookVerification(). - Before upgrading, follow
docs/V6_MIGRATION_GUIDE.md.
Features
- rewrite the Laravel integration as a thin adapter over
workos/workos-phpv5, bind\WorkOS\WorkOSdirectly, and expose the upstream v5 service surface (https://github.com/workos/workos-php-laravel/issues/87" rel="noreferrer" target="_blank">#87) (https://github.com/workos/workos-php-laravel/commit/b72cb58803a14826a0daeec6b2d2adec549c69eb" rel="noreferrer" target="_blank">b72cb58)
March 20, 2026
workos/workos-php-laravel: v5.1.0
March 20, 2026
workos/workos-php-laravel-v5.0.1...workos/workos-php-laravel-v5.1.0" rel="noreferrer" target="_blank">5.1.0 (2026-03-20)
Features
- add Facade, improve performance and ergonomics (https://github.com/workos/workos-php-laravel/issues/69" rel="noreferrer" target="_blank">#69) (https://github.com/workos/workos-php-laravel/commit/32cae0fe8567fae1891e71f2c4a1bbbffd48a9db" rel="noreferrer" target="_blank">32cae0f)
Bug Fixes
- update renovate rules (https://github.com/workos/workos-php-laravel/issues/78" rel="noreferrer" target="_blank">#78) (https://github.com/workos/workos-php-laravel/commit/2fbd0849596b2b6dd07a103becc467876ce94a28" rel="noreferrer" target="_blank">2fbd084)
Miscellaneous Chores
- Add DX as Codeowners (https://github.com/workos/workos-php-laravel/issues/81" rel="noreferrer" target="_blank">#81) (https://github.com/workos/workos-php-laravel/commit/bea596841fb57b7b66adc0b95366c8f2e691d882" rel="noreferrer" target="_blank">bea5968)
- deps: update actions/checkout action to v6 (https://github.com/workos/workos-php-laravel/issues/74" rel="noreferrer" target="_blank">#74) (https://github.com/workos/workos-php-laravel/commit/1140490d79a4186ff7a8d818c97211fff2287374" rel="noreferrer" target="_blank">1140490)
- deps: update actions/create-github-app-token action to v3 (https://github.com/workos/workos-php-laravel/issues/84" rel="noreferrer" target="_blank">#84) (https://github.com/workos/workos-php-laravel/commit/400e880dae8a5c6c06b5edf1e22c35d6b41a53e0" rel="noreferrer" target="_blank">400e880)
- deps: update amannn/action-semantic-pull-request action to v6 (https://github.com/workos/workos-php-laravel/issues/85" rel="noreferrer" target="_blank">#85) (https://github.com/workos/workos-php-laravel/commit/345ca71443287fc45c8f9c3a3995950a79755be9" rel="noreferrer" target="_blank">345ca71)
- Pin GitHub Actions (https://github.com/workos/workos-php-laravel/issues/79" rel="noreferrer" target="_blank">#79) (https://github.com/workos/workos-php-laravel/commit/2a88f7b59f54edafc089e511504b30101af7697d" rel="noreferrer" target="_blank">2a88f7b)
December 6, 2025
v5.0.1
December 6, 2025
December 5, 2025
v5.0.0
December 5, 2025
What's Changed
- Require Laravel 10x+ by @antn in #65
- Bump workos-php to v4.29.0 by @kendallstrautman in #66
- Bump version to v5.0.0 by @kendallstrautman in #67
New Contributors
- @antn made their first contribution in #65
Full Changelog: v4.4.0...v5.0.0
October 7, 2025
v4.4.0
October 7, 2025
What's Changed
New Contributors
- @csrbarber made their first contribution in #62
Full Changelog: v4.3.0...v4.4.0
June 23, 2025
v4.3.0
June 23, 2025
What's Changed
- Upgraded to workos-php v4.26.0 (https://github.com/workos/workos-php-laravel/pull/60)
Full Changelog: v4.2.0...v4.3.0
June 3, 2025
v4.2.0
June 3, 2025
What's changed?
- Pin dependencies using sha #57
- Upgrade workos-php to v4.24.0 to #58
October 22, 2024
v4.1.0
October 22, 2024
What's Changed
- Version bump - https://github.com/workos/workos-php/releases/tag/v4.14.0" rel="noreferrer" target="_blank">workos-php@4.14.0 by @kendallstrautman in #54
See https://github.com/workos/workos-php/releases" rel="noreferrer" target="_blank">workos-php releases
Full Changelog: v4.0.0...v4.1.0
November 22, 2023
v4.0.0
November 22, 2023
Breaking Change
- Bumped
workos-phppackage version to v4.0.0 (https://github.com/workos/workos-php-laravel/pull/50" rel="noreferrer" target="_blank">#50)
Follow https://github.com/workos/workos-php/releases" rel="noreferrer" target="_blank">workos/workos-php releases to catch the latest changes
May 4, 2023
v3.1.0
May 4, 2023
April 21, 2023
v3.0.0
April 21, 2023
Updated
- Updated
workos-php-laravelversion to 3.0.0 to align withworkos-php3.x.x versioning.
December 9, 2022
v2.0.0
December 9, 2022
Breaking Change
- Bump
workos-phppackage version to v2.1.0 (https://github.com/workos/workos-php-laravel/pull/36) (follow https://github.com/workos/workos-php/releases" rel="noreferrer" target="_blank">workos/workos-php releases to catch the latest changes)
October 20, 2022
v1.8.0
October 20, 2022
Updated
- Updated
workos-phpversion to 1.17.0
September 29, 2022
v1.7.0
September 29, 2022
Changed
- Upgraded to v1.16.0 of workos-php
September 27, 2022
v1.6.0
September 27, 2022
Changed
- Upgraded to v1.14.0 of workos-php
April 13, 2022
v1.5.0
April 13, 2022
Changed
- Split
AuthenticationChallengeresource intoAuthenticationChallengeTotpandAuthenticationChallengeSms
March 30, 2022
v1.4.0
March 30, 2022
Added
- Added support for Laravel 9 (https://github.com/workos/workos-php-laravel/pull/27" rel="noreferrer" target="_blank">#27)
February 25, 2022
v1.3.0
February 25, 2022
Changed
- Upgraded Workos PHP package to all versions until 2.0
February 11, 2022
v1.2.0
February 11, 2022
Changed
- Upgraded to v1.6.0 of workos-php
October 28, 2021
v1.1.0
October 28, 2021
Changed
- Bumped
workos/workos-phpversion to1.3.0(#19)
June 24, 2021
v1.0.1
June 24, 2021
Fixed
- Fixed bug on previous version, updated PHP SDK in the composer file
June 24, 2021
v1.0.0
June 24, 2021
Changed
- Updated WorkOS PHP SDK version to 1.0.0
Deprecated
- Deprecated
project_idin favor odclient_id
April 23, 2021
v0.9.1
April 23, 2021
Changed
- Updated Laravel support to include version 8
January 13, 2021
v0.9.0
January 13, 2021
Changed
- Removed project ID and added environment ID to EventAction and Directory resources
Deprecated
- Deprecate project ID in favor of client ID
- Retired promoteDraftConnection
January 12, 2021
v0.8.0
January 12, 2021
Added
- Added support for Passwordless
October 14, 2020
v0.7.0
October 14, 2020
Added
- Exposed
connection_idattribute on Profile objects
September 14, 2020
v0.5.1
September 14, 2020
Fixed
- Fixed issue when translating API response to a Connection resource