---
title: "Verify a sign-up code"
method: POST
path: "/api/v1/auth/verify"
tags: ["authentication"]
---

# Verify a sign-up code

`POST /api/v1/auth/verify`

Verifies the one-time code for a `verificationId`. On first verification
the account is created, an API key is issued, and a first phone number is
provisioned. **The API key is returned only once — store it immediately.**

When a new number is provisioned, `inboundInstruction` is **optional** —
it becomes that number's inbound voice-agent prompt, and a default greeting
is used if you omit it. For an existing account (no new number provisioned)
`inboundInstruction` is ignored.

## Request body

- object
  - `verificationId` string, required
  - `code` string, required — The 6-digit code from the email.
  - `inboundInstruction` string — System prompt for the AI voice agent on calls to the auto-provisioned number. Optional — a default greeting is used if omitted when a new number is created; ignored when signing in to an existing account.

## Response `200`

Verified.

- AuthenticationVerifySignupResponse200
  - `apiKey` string — Your API key. Shown once on account creation.
  - `accountId` string
  - `phoneNumber` string, nullable — The number auto-provisioned for a new account, if any.
  - `phoneNumberId` string, nullable
  - `message` string

## Other responses

- `400` — The request body failed validation.
- `401` — Missing or invalid API key.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/versions/cfa621230237/schema)