← Clerk

Can an agent create a user with Clerk Backend API?

A person steps in at setup: a person hands over a key or token, a person signs up or registers a client for it and a person replaces or revokes its access when it must change. Job reachable, not yet run.

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 own machine-readable documents lead an agent to the job's interface.

  2. 02

    Authority

    Workaround · setup

    A person hands the agent a key or token.

  3. 03

    Onboard

    Workaround · setup

    A person signs up, or registers a client, for the agent.

  4. 04

    Pay

    Not applicable

    Nothing to pay for the job.

  5. 05

    Confirm

    Machine

    A failure comes back typed, in its answer or as its spec declares, so an agent can tell a failure from a success.

  6. 06

    Sustain

    Workaround · setup

    A person replaces or revokes the agent's access when it must change.

A person once, at Authority: handing over a key or token.

A person once, at Onboard: signing up or registering a client for the agent.

A person once, at Sustain: renewing, replacing or revoking its access.

Not A+ yet: OAuth that lets an agent register its own client would turn handing over a key or token into a one-time consent; a way for agents to register (auth.md, a sign-up API, or OAuth with client registration) would let the agent register itself; a key-management API, or OAuth refresh and revocation, would let the agent keep its access alive.

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