---
title: "Ask for a beta access code by email. No auth."
method: POST
path: "/v1/access/requests"
tags: ["access"]
---

# Ask for a beta access code by email. No auth.

`POST /v1/access/requests`

## 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/access/requests`
- Auth: none declared

Ask for the beta access code a new account needs. Send your email and, if you like,
a short note. The owner approves the request and the code is emailed to you at once;
it works once, on the web or as access_code on POST /v1/accounts. The answer is 202
with status pending (waiting for approval) or emailed (sent now). Asking again while a
request is pending changes nothing. Limited to 5 requests per address per hour (429).
No key needed. Free. MCP: request_access.

## Request body

- AccessRequestIn
  - `email` string, required: where the code is sent
  - `note` string, nullable: optional: who you are, what you will use it for (up to 500 characters)

## Response `202`

Successful Response

- AccessRequestOut
  - `status` 'pending' | 'emailed', required: pending: waits for the owner's approval, then the code is emailed; emailed: the code is on its way now
  - `message` string, required

## Other responses

- `413`: request body over the size cap
- `422`: invalid input
- `429`: rate limited; see Retry-After
- `500`: our fault; names the request id

---

[API](https://skmtc.dev/hookdetector/apis/hook-detector.md) · [All operations](https://skmtc.dev/hookdetector/apis/hook-detector/llms.txt) · [OpenAPI document](https://skmtc.dev/hookdetector/apis/hook-detector/revisions/b136a2804d2b?raw)