Skip to main content
POST
Send a verification code to a customer's email or phone

Authorizations

Authorization
string
header
default:BASIC <Meld API Key>
required

Headers

Meld-Version
string

Dated API version to use for this request, e.g. 2026-02-03.

Example:

"2026-02-03"

Authorization
string

Path Parameters

customerId
string
required

Customer id

Body

application/json

Request to send a verification code to a customer's email or phone

channel
enum<string>
required

Contact channel to verify

Available options:
EMAIL,
PHONE
Minimum string length: 1
serviceProvider
string

Optional service provider context for the verification

Example:

"COINBASEPAY"

target
string

Email address or E.164 phone number to send the code to. Optional for widget sessions with locked targets, where the customer's stored contact value is used.

Response

Verification is returned

State of a contact verification

channel
enum<string>

Contact channel

Available options:
EMAIL,
PHONE
expiresAt
string

When the code expires (ISO-8601)

resendAvailableAt
string

When a new code can be requested (ISO-8601)

status
enum<string>

Verification status

Available options:
PENDING,
VERIFIED,
EXPIRED,
FAILED,
INVALIDATED
target
string

Masked contact value the code was sent to

Example:

"j•••@example.com"

verificationId
string

Verification id