---
title: "Update calling config"
method: PATCH
path: "/v1/phone-numbers/{id}/whatsapp/calling"
tags: ["WhatsApp Calling"]
---

# Update calling config

`PATCH /v1/phone-numbers/{id}/whatsapp/calling`

Update fields on an already-enabled number. Only fields present in
the body are written; `undefined` leaves the stored value alone,
explicit `null` clears a nullable field. No Meta side effect, this
only changes local routing state consumed by the Telnyx webhook
handler.

## Path parameters

- `id` string, required

## Request body

- object
  - `accountId` string, required
  - `forwardTo` string
  - `sipAuthUsername` string, nullable
  - `sipAuthPassword` string, nullable
  - `recordingEnabled` boolean
  - `callIconCountries` string[], nullable
  - `maxCallDurationSeconds` integer, nullable — Hard cap (seconds) on forwarded calls; null clears the cap.
  - `forwardCallerId` 'business' | 'caller' — caller = present the WhatsApp user's number to the forward destination (sip: only).

## Response `200`

Updated

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Phone number not found
- `422` — Calling must be enabled before settings can be updated

---

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