accounts

Sign up with a beta access code. No auth, no form, no human step.

Create an account and get an API key with free credits. Needs a beta access code as access_code (403 access_code_required without one, 403 invalid_access_code for one that does not work; ask at hookdetector.com/access). The key in this response is the only copy that will ever exist: store it, then send it as Authorization: Bearer hd_... on every other call. Signups are limited per address per hour (an IPv6 caller per /64), and so are wrong codes; the X-RateLimit headers say where you stand. Free. MCP: create_account.

post/v1/accounts

Request

Base URL: https://api.hookdetector.com (the document declares no server; this is the origin it was published from)
URL: https://api.hookdetector.com/v1/accounts
Auth: none declared

Request body

labelstring nullable

your own note, to tell accounts apart

access_codestring nullable

your beta access code, HD-XXXX-XXXX (case and dashes do not matter). Required: without it the answer is 403 access_code_required. Ask for one at hookdetector.com/access.

Example request

{
  "label": "my research agent",
  "access_code": "HD-7K3M-Q9TX"
}

Response

Successful Response

account_idstring required

api_keystring required

the only copy there will ever be; store it now

creditsinteger required

created_atstring required

messagestring required

nextstring required

Example response

{
  "account_id": "8f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
  "api_key": "hd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "created_at": "2026-09-23T10:00:00.000000+00:00",
  "credits": 500,
  "message": "This is the only copy of your key.",
  "next": "POST /v1/research"
}

Changes

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