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 the beta versions, refer to the README in the GitHub repository.
Releases
June 23, 2025
v4.26.0
Latest
June 23, 2025
What's Changed
Added support for custom scopes (https://github.com/workos/workos-php/pull/289)
Full Changelog: https://github.com/workos/workos-php/compare/v4.25.0...v4.26.0
June 17, 2025
v4.25.0
June 17, 2025
What's Changed
Add permissions attribute to Role by @MrCrayfish in https://github.com/workos/workos-php/pull/287
New Contributors
@MrCrayfish made their first contribution in https://github.com/workos/workos-php/pull/287
Full Changelog: https://github.com/workos/workos-php/compare/v4.24.0...v4.25.0
May 22, 2025
v4.24.0
May 22, 2025
What's Changed
Fixes $roleSlug behavior on updateOrganizationMembership (no longer required) (#278)
Adds $roleSlug to createOrganizationMembership (#278)
Adds $email to updateUser (#285)
April 25, 2025
v4.23.0
April 25, 2025
What's Changed
Structured responses to webhook events by @bradenkeith in #265
IDE & Typehint improvements by @bradenkeith in #264
Pin third-party actions to currently used SHA by @nickcollisson-workos in #275
Add customAttributes field to SSO Profile by @mattgd in #276
New Contributors
@bradenkeith made their first contribution in https://github.com/workos/workos-php/pull/265
@nickcollisson-workos made their first contribution in https://github.com/workos/workos-php/pull/275
Full Changelog: https://github.com/workos/workos-php/compare/v4.22.0...v4.23.0
Full Changelog: https://github.com/workos/workos-php/compare/v4.14.0...v4.15.0
October 21, 2024
v4.14.0
October 21, 2024
What's Changed
Add role to profile by @kendallstrautman in https://github.com/workos/workos-php/pull/246
Full Changelog: https://github.com/workos/workos-php/compare/v4.13.0...v4.14.0
August 7, 2024
v4.13.0
August 7, 2024
Added
Added a new organizationId parameter to the authenticateWithRefreshToken method (#244)
July 18, 2024
v4.12.0
July 18, 2024
What's Changed
Add Apple and GitHub OAuth support by @gcarvelli in https://github.com/workos/workos-php/pull/238
Full Changelog: https://github.com/workos/workos-php/compare/v4.11.1...v4.12.0
July 11, 2024
v4.11.1
July 11, 2024
What's Changed
Fixes a bug with leading slashes from various UM functions by @sheldonvaughn in https://github.com/workos/workos-php/pull/241
Full Changelog: https://github.com/workos/workos-php/compare/v4.11.0...v4.11.1
June 24, 2024
v4.11.0
June 24, 2024
Deprecated
Marked $allowProfilesOutsideOrganization option parameter as deprecated (#239)
June 4, 2024
v4.10.0
June 4, 2024
Added
Added a method to find an invitation using the token (#236)
May 24, 2024
v4.9.0
May 24, 2024
Added
Added inviterUserID to invitation object returned by API (#234)
Added new endpoints to the User Management API to support sending your own emails: getEmailVerification, getPasswordReset, and createPasswordReset (#234)
Deprecation notice for the sendPasswordResetEmail method in favor of createPasswordReset (#234)
May 22, 2024
v4.8.1
May 22, 2024
What's Changed
Fix bug with URL parsing by @PaulAsjes in https://github.com/workos/workos-php/pull/233
Full Changelog: https://github.com/workos/workos-php/compare/v4.8.0...v4.8.1
May 17, 2024
v4.8.0
May 17, 2024
What's Changed
Add organization membership deactivate and reactivate API methods by @mattgd in https://github.com/workos/workos-php/pull/227
Add logout url method by @PaulAsjes in https://github.com/workos/workos-php/pull/231
Full Changelog: https://github.com/workos/workos-php/compare/v4.7.0...v4.8.0
May 14, 2024
v4.7.0
May 14, 2024
What's Changed
Auth with refresh token and fix some tests by @PaulAsjes in https://github.com/workos/workos-php/pull/229
Properly check if a value exists within a BaseWorkOSResource by @abellion in https://github.com/workos/workos-php/pull/226
New Contributors
@PaulAsjes made their first contribution in https://github.com/workos/workos-php/pull/229
@abellion made their first contribution in https://github.com/workos/workos-php/pull/226
Full Changelog: https://github.com/workos/workos-php/compare/v4.6.0...v4.7.0
May 3, 2024
v4.6.0
May 3, 2024
Added
Added acceptInvitationUrl to invitation object returned by API (#224)
Added new endpoints for the Magic Auth API: getMagicAuth and createMagicAuth (#224)
Deprecation notice for sendMagicAuthCode method in favor of createMagicAuth (#224)
May 2, 2024
v4.5.0
May 2, 2024
Added
Add domain_data to Organizations Create and Update methods to replace the now deprecated domains parameter (#221)