---
title: 'Verify Phone OTP and Connect'
description: 'Verifies the OTP code and connects the phone number to the user profile.'
openapi: POST /api/phone_verifications/connect
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`POST /api/phone_verifications/connect`

`POST https://admin.snagsolutions.io/api/phone_verifications/connect`

Verifies the OTP code and connects the phone number to the user profile.

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Request body

- Content type: `application/json`
  - request body (object) — Request body for verifying OTP and connecting phone number
    - `phoneNumber` (string, required) — Phone number in E.164 format (e.g., +14155552671)
    - `code` (string, required) — The OTP code received via SMS
    - `websiteId` (string, uuid) — The ID of the website
    - `userId` (string, uuid) — The ID of the user
    - `walletAddress` (string) — The wallet address of the user

## Response 200

200
  - response (object) — Standard response wrapper after verifying OTP and connecting phone number
    - `data` (object, required) — Response payload after verifying the OTP code and connecting the phone number
      - `success` (boolean, required) — Whether the phone number was verified successfully
      - `message` (string) — Status message
      - `error` (string) — Error code if verification failed
      - `accountLinkData` (string) — JWT-encoded data for resolving account link conflicts when the phone is already linked

## Response 400

400
  - response (object) — Schema for bad request response
    - `message` (string, required) — Error message

## Response 403

403
  - response (object) — Schema for forbidden response
    - `message` (string, required) — Error message

## Response 500

500
  - response (object) — Schema for internal server error response
    - `success` (boolean, required) — Indicates operation success
    - `message` (string, required) — Error message
    - `debugInfo` (string) — Optional debug information


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip