---
title: "Ask a user for permission to call them"
method: POST
path: "/v1/whatsapp/call-permissions"
tags: ["WhatsApp"]
---

# Ask a user for permission to call them

`POST /v1/whatsapp/call-permissions`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/whatsapp/call-permissions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Sends Meta's interactive `call_permission_request` message from `number_id` to `user` with your `text`. Meta limits this to 1 request per 24 hours and 2 per 7 days per user; the user's reply is recorded from the webhook and gates `POST /v1/whatsapp/calls`. Requires the `telephony:manage` scope.

## Request body

- WhatsAppPermissionRequest
  - `number_id` string, required
  - `to` string, required: The user's WhatsApp number (E.164).
  - `text` string, required: Why you want to call, shown in the permission prompt.

## Response `202`

Request sent

- object
  - `object` string
  - `number_id` string
  - `user` string
  - `message_id` string, nullable

## Other responses

- `400`: Invalid request (bad field, unsupported value)
- `401`: Missing or invalid API key (`code: unauthorized`)
- `404`: Resource not found (`code: not_found`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/271a1539185b?raw)