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

See the API Reference for Go usage examples.

Install the package with:

go get -u github.com/workos/workos-go/v4...

To use the library you must provide an API key, located in the WorkOS dashboard, as an environment variable WORKOS_API_KEY:

WORKOS_API_KEY="sk_1234"

Or, you can set it on your own before your application starts:

sso.Configure(
  "<WORKOS_API_KEY>",
  "<CLIENT_ID>",
  "https://foo-corp.com/redirect-uri"
);

directorysync.SetAPIKey("<WORKOS_API_KEY>");

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.

• User Management Guide
• Single Sign-On Guide
• Directory Sync Guide
• Admin Portal Guide
• Magic Link Guide