Clerk API (unofficial showcase)
POST/redirect_urls

Create a redirect URL

Creates a redirect URL. When you provide a request body, include url as a full URL prefixed with https:// or a URL using a custom scheme. The response includes the created redirect URL and its timestamps.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

Redirect URL details.

urlstringrequired
The full URL value prefixed with `https://` or a custom scheme e.g. `"https://my-app.com/oauth-callback"` or `"my-app://oauth-callback"`

3 status codes
200Returns the created redirect URL object, including its ID, URL, and creation and update timestamps.
objectstringrequired
Allowed:redirect_url
idstringrequired
urlstringrequired
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
400Returned when the request is not successful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
422Returned when request parameters are invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is unsuccessful, and a 422 when request parameters are invalid. When you provide a request body, include url as a full URL prefixed with https:// or a custom-scheme URL.