---
title: "Request or verify a recipient's six-digit code"
method: POST
path: "/api/v1/addresses/{addressId}/email/contacts"
tags: ["Mail"]
---

# Request or verify a recipient's six-digit code

`POST /api/v1/addresses/{addressId}/email/contacts`

## Request

- Base URL: `https://agentaddress.dev`
- URL: `https://agentaddress.dev/api/v1/addresses/{addressId}/email/contacts`
- Auth: HTTP bearer

Omit code to request a verification email; include code to confirm. Requires authorization to contact the recipient. 15-minute expiry, five failed guesses, 10 contacts/address. Requests: 5/IP/hour, 3/recipient/UTC day, 3/address/hour; shared service outbound budget. Sending must be configured.

## Path parameters

- `addressId` string, required

## Request body

- object
  - `email` string, email, required
  - `code` string

## Response `200`

Authorized response; never cached

- ContactVerification
  - `email` string, email, required
  - `verified` boolean, required
  - `expires_in_seconds` integer

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `429`: Wait Retry-After seconds; minute, hourly or UTC daily window applies
- `502`: Structured API error
- `503`: Structured API error

---

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