---
title: "Initialize sms verification process"
method: POST
path: "/sdk/{environmentId}/smsVerifications/create"
tags: ["SDK"]
---

# Initialize sms verification process

`POST /sdk/{environmentId}/smsVerifications/create`

## Path parameters

- `environmentId` string, required

## Request body

- SmsVerificationCreateRequest
  - `phoneCountryCode` string, required
  - `phoneNumber` string, required
  - `isoCountryCode` string, required
  - `captchaToken` string — When provided, used to verify that a captcha is valid and get the success/failure result from the captcha provider server-side.

## Response `201`

Successful response, that contains verification UUID.

- SmsVerificationCreateResponse
  - `verificationUUID` string, required
  - `phoneNumber` string, required — This field contains the phone number in the country. This could also contain the area code within a country.
  - `phoneCountryCode` string, required — This field contains the phone international country code. See https://countrycode.org/
  - `isoCountryCode` string, required — ISO-3166 two-character country code. See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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