webhook
workos

Workos User Registration Action

Handle a WorkOS AuthKit User Registration Action.

WorkOS POSTs a signed payload at sign-up time; we verify the signature, then return a signed Allow/Deny verdict. Signature verification always runs and always fails closed (bad signature -> 401, missing secret -> 500) regardless of environment. The domain restriction itself is only enforced when the running environment is in signup_restricted_environments and an allowlist is configured; otherwise the action is a pass-through (always Allow).

post/webhook/workos/actions/user-registration

Request

  • Base URL: https://api.cloud.wherobots.com
  • URL: https://api.cloud.wherobots.com/webhook/workos/actions/user-registration
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

WorkOS-Signaturestring nullable

WorkOS Action payload signature

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.