---
title: "Create a verification"
method: POST
path: "/accounts/{account_id}/verifications"
tags: ["Verifications"]
---

# Create a verification

`POST /accounts/{account_id}/verifications`

Creates a new Verification for an account and sends the code to the given phone number.

## Path parameters

- `account_id` string, required — The account to associate with the verification.

## Request body

- VerificationParams — Parameters for creating a Verification
  - `phone_number` string, phone-number, required — The phone number to be verified. In E.164 format.

## Response `201`

Created verification

- Verification — A phone number verification
  - `attempt_count` integer, required — The number of times the code has been attempted.
  - `id` string, required — Unique identifier for the object.
  - `phone_number` string, phone-number, required — The phone number being verified. In E.164 format.
  - `status` 'pending' | 'verified' | 'exhausted' | 'expired', required — The current status of the verification.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/revisions/b5b0b6f62245/schema)