← Clerk

Can an agent create a user with Clerk Backend API?

The agent needs you to sign it up or register a client and provide a key or token. You also handle changes to its access.

observedProbed revision sha256:79e24f4f8885…

Who does each step

Whether the agent handles it alone or a person has to step in.

  1. 01

    Discover

    Machine

    The vendor's machine-readable docs show the agent where and how to call this job.

  2. 02

    Access

    Workaround · setup

    You give the agent a key or token.

  3. 03

    Onboard

    Workaround · setup

    You sign up or register a client for the agent.

  4. 04

    Pay

    Not applicable

    Nothing to pay for the job.

  5. 05

    Confirm

    Machine

    The response or specification defines errors the agent can distinguish from success.

  6. 06

    Sustain

    Workaround · setup

    You replace or revoke the agent's access when it needs to change.

  • Access: handing over a key or token.
  • Onboard: signing up or registering a client for the agent.
  • Sustain: renewing, replacing or revoking its access.

To remove these handoffs: support OAuth client registration so the agent can register its own client and ask for consent; provide an agent registration route, such as auth.md, a sign-up API or OAuth client registration; provide key management or OAuth refresh and revocation so the agent can maintain its own access.

Agent surfaces

4 kinds · 7 entries
For agentsNames the job's endpoint
API catalogapi-catalog
MCPserver card

The probe

11 Oct 2026 · 23:17 UTC · 60.67 s

Each request it sent and what came back; the descriptors it read, counted, with what they named.

Discover43 descriptor reads9 facts
Found
API catalogapi.clerk.com/v1API catalogapi.clerk.com/v1MCPmcp.clerk.com/mcpFor agentsclerk.com/llms.txtAPI catalogapi.clerk.com/v1For agentsapi.clerk.comAPI catalogapi.clerk.com/v1API catalogapi.clerk.com/v1APIexample-destined-camel-13.clerk.accounts.dev
From
clerk.com/.well-known/api-catalog · clerk.com/.well-known/mcp/server-card.json · clerk.com/llms.txt · clerk.com/docs/reference/spec/bapi/latest.json · clerk.com/docs/reference/backend/overview · clerk.com/docs/reference/spec/bapi/latest.yml · clerk.com/docs/reference/spec/platform/latest.yml · clerk.com/docs/reference/spec/fapi/latest.yml
This endpoint
api.clerk.com/v1 is named by a descriptor it read
Job requestPOST api.clerk.com/v1/users40174 ms
Request
POST https://api.clerk.com/v1/users
Response
401 · application/json · 255 bytes
Body
sha256:91aadd4b61a002a36d02a134bfc111cc94cadc51f7b8a80242566adabafea4e4
Exchange
sha256:efc7a71b0b7a0ad9f9c4c5dc9ec07ee1d28599b27ae8b246761d04df97959288
Resource metadataGET api.clerk.com/.well-known/oauth-protected-resource/v1/users40484 ms
Request
GET https://api.clerk.com/.well-known/oauth-protected-resource/v1/users
Response
404 · text/plain · 19 bytes
Body
sha256:b16e15764b8bc06c5c3f9f19bc8b99fa48e7894aa5a6ccdad65da49bbf564793
Exchange
sha256:5ad9c3ea8a51b23c6b05589f36f7f10581c2f89157eaae9857b6b61e93d9a291
Resource metadataGET api.clerk.com/.well-known/oauth-protected-resource40473 ms
Request
GET https://api.clerk.com/.well-known/oauth-protected-resource
Response
404 · text/plain · 19 bytes
Body
sha256:b16e15764b8bc06c5c3f9f19bc8b99fa48e7894aa5a6ccdad65da49bbf564793
Exchange
sha256:fd8274fd03e29d2e0327882652d81fe4e9a2830cb0f725470e0e7e2527badd5c
Declared pageGET dashboard.clerk.com/sign-up200271 ms
Request
GET https://dashboard.clerk.com/sign-up
Response
200 · text/html · 139204 bytes
Body
sha256:82cffc58dbbecd416561b459e3741f85dce7a994359ddc66c8756db7e23516a3
Exchange
sha256:2364251d08dcb1cea4084e093318a03e6ebfc17af26cec39680f5c82e4ec5dd7

Clerk on the startup-offers board

The grade’s badge

One image that keeps itself current, linking here.

Live badge for Clerk Backend API, agent grade: B+[![agent grade](https://sourcey.com/badges/agent-readiness/arp_01m4pm3cywv0x246sqtpn64cks.svg)](https://sourcey.com/c/clerk/agent-readiness/clerk-backend-api/user-create)

Improve the report

Correct it, probe it again, or improve the path.

Profile
arp_01m4pm3cywv0x246sqtpn64cks
Projection
sha256:7998622f0cd71483840372425580ed5add33efcc9716199de59a7340bc97c8dd
Policy
kind-2026-10-12 · sha256:0a4e4996176ce674b4f3ce910c5fca4f37c9b53bcdf51656d53a1a92fcf2c879