---
title: "Send a verification code to a phone number"
method: POST
path: "/v1/sms/numbers/send-code"
---

# Send a verification code to a phone number

`POST /v1/sms/numbers/send-code`

Sends a one-time verification code via iMessage or SMS to the given phone number

## Request body

- union
  - object
  - SMSSendCodeRequest
    - `phoneNumber` string, required

## Response `200`

OK

- SMSSendCodeSuccessResponse
  - `expiresAt` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.dev/b3os/apis/b3os-workflow-api.md) · [All operations](https://skmtc.dev/b3os/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/b3os/b3os-workflow-api/revisions/a8c7af3c66a1/schema)