agent

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 the Free plan's entitlements are applied: 3 inboxes and 100 emails per day, at first to at most 3 distinct recipients in the first hour, 5 in the first day, and 10 in the first week.

The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same human_email to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a human_email has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on console.agentmail.to using the human email address you provided to verify your account.

CLI:

agentmail agent verify --otp-code 123456
post/v0/agent/verify

Request

  • Base URL
    https://api.agentmail.to
  • URL
    https://api.agentmail.to/v0/agent/verify
  • Auth
    HTTP bearer

Request body

otp_codestring required

6-digit verification code sent to the human's email address.

Response

Response with status 200

verifiedboolean required

Whether the organization was verified.

Changes

    • info

      the endpoint scheme security Bearer was added to the API

    • info

      the endpoint scheme security BearerAuth was removed from the API

    • info

      api tag agent added

    • info

      api tag Agent removed

    • info

      request body became optional

    • info

      endpoint added