---
title: "Ask for a code at a site's email gate"
method: POST
path: "/api/sites/{slug}/capture/request"
tags: ["site-controller"]
---

# Ask for a code at a site's email gate

`POST /api/sites/{slug}/capture/request`

## Request

- Base URL: `https://api.pagegoat.com`
- URL: `https://api.pagegoat.com/api/sites/{slug}/capture/request`
- Auth: HTTP bearer

Mails a six-digit code. On a site set to "email only, no code" it returns the gate pass directly and there is no second step.

## Path parameters

- `slug` string, required

## Request body

- CaptureRequest: Ask for a code (or, on a site that requires none, for entry) at an email gate.
  - `email` string, required: Required.

## Response `200`

A code is on its way — or, with no code required, here is the pass.

## Other responses

- `400`: That isn't an email address.
- `403`: Blocked, or a domain the site doesn't accept.
- `404`: No such site, or it isn't capturing emails.
- `429`: Too many requests; wait it out.

---

[API](https://skmtc.dev/pagegoat/apis/pagegoat-api.md) · [All operations](https://skmtc.dev/pagegoat/apis/pagegoat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagegoat/apis/pagegoat-api/revisions/3e87219680af?raw)