Elixir SDK

def deps do
  [{:workos, "~> 0.1.3"}]
end

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

See the API Reference for Elixir usage examples.

Add this package to the list of dependencies in your mix.exs file:

def deps do
  [{:workos, "~> 1.0"}]
end

Requires Elixir 1.18 or later.

Build a client with your API key, then pass it to any API function:

client = WorkOS.client(api_key: "sk_example_123456789")
# or set the WORKOS_API_KEY environment variable and call WorkOS.client()

{:ok, organization} = WorkOS.Organizations.get_organization(client, "org_01EHZNVPK3SFK441A1RGBFSHRT")

All API functions take the client as their first argument and return {:ok, result} or {:error, error} tuples. Errors are typed: WorkOS.ApiError for non-2xx API responses (with a :kind atom such as :not_found) and WorkOS.TransportError for network failures.

Client configuration is per-instance — there is no global state. Options: :api_key, :base_url, :timeout, :max_retries, :req_options. Per-request options (:headers, :timeout, :idempotency_key, :query) can be passed as the final argument to any API function.

Pagination

List endpoints return a WorkOS.Page. Use WorkOS.Page.stream/1 to lazily iterate across every page:

{:ok, page} = WorkOS.Organizations.list_organizations(client)

page
|> WorkOS.Page.stream()
|> Enum.each(&IO.inspect/1)

For our SDKs WorkOS follows a Semantic Versioning process where all releases will have a version X.Y.Z (like 1.0.0) pattern wherein Z would be a bug fix (I.e. 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
• Domain Verification Guide