---
title: "Verify"
method: POST
path: "/v0/agent/verify"
tags: ["Agent"]
---

# Verify

`POST /v0/agent/verify`

Verify an agent organization using the 6-digit OTP sent to the human's email during sign-up.

On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.

The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.

**CLI:**
```bash
agentmail agent verify --otp-code 123456
```

## Request body

- AgentVerifyRequest — Request body to verify an agent with an OTP code.
  - `otp_code` string, required — 6-digit verification code sent to the human's email address.

## Response `200`

- AgentVerifyResponse — Response after successful agent verification.
  - `verified` boolean, required — Whether the organization was verified.

## Changes

- **2026-03-31** `27965096e618` — 1 info
  - endpoint added
- **2026-03-28** `8a5b5e92ae2d` — 1 breaking
  - api path removed without deprecation
- **2026-03-28** `543818df77d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/agent/verify/post.md)

---

[API](https://skmtc.dev/agentmail-to/apis/api.md) · [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentmail-to/api/revisions/394ddcdd9c29/schema)