---
title: "Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone"
method: POST
path: "/api/mcp/tools/start_owner_phone_verification"
tags: ["tools"]
---

# Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone

`POST /api/mcp/tools/start_owner_phone_verification`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/start_owner_phone_verification`
- Auth: HTTP bearer

Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone. This is the one-time ownership proof required before a platform number can be connected, and it also unlocks agents messaging the owner. Ask the user for their own WhatsApp number first and send only to that. No WhatsApp Business account is involved.

## Request body

- object
  - `phone` string, required: The owner's own WhatsApp number, ideally in E.164 form such as +972501234567.
  - `region` string: Optional ISO region hint (for example IL, US) used when the number has no country code.

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)