Skip to main content

Pre-provision (invite) an end user (server-side admin)

POST 
/auth/users/invite

Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when send_link is set, sends a first-login link so the user can set up their account without self-registration.

  • send_link: "magic" sends a magic-link sign-in email.
  • send_link: "password_reset" sends a set-password email.
  • send_link: "none" (default) creates the user with no email.

A redirect_url is required when send_link is "magic" or "password_reset"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted).

Request​

Responses​

User provisioned (and link sent when requested)