ReferenceWhatsApp Business API
Update calling settings
POST
Enable, disable, or update WhatsApp Calling settings (beta).
Proxies upstream POST /calling/settings.
Body is forwarded as-is (1msg does not validate fields).
Common fields under calling
status(ENABLED|DISABLED) — required to turn calling on/offcall_icon_visibility(DEFAULT|DISABLE_ALL) — optionalcallback_permission_status(ENABLED|DISABLED) — optional; when enabled, inbound user calls grant callback permissioncall_hours— optional hours / timezone objectsip— optional SIP trunk; when SIP is ENABLED, Graph call actions and calling webhooks are not usedsrtp_key_exchange_protocol(DTLS|SDES) — SDES only with SIPvideo.status— optional
Meta may accept only one feature group per request — prefer focused updates (e.g. enable status first, then SIP).
Trial / subscriptionBlocked → 403 plain text.
JWT tokenquery
token<token>application/json- body
Calling settings payload for GET/POST /callingSettings.
Proxies upstream GET|POST /calling/settings.
Extra Meta fields may appear on GET responses; document core fields below.
calling?Calling feature configuration for the business phone number
[key: string]?anyUsually { "success": true } from upstream, or legacy
{ "result": "success" } / { "response": { "error": "..." } }.
application/json- response
success?booleanresult?stringresponse?[key: string]?anycurl -X POST 'https://api.1msg.io/123/callingSettings' \ -H 'Content-Type: application/json' \ -d '{ "calling": { "status": "ENABLED", "call_icon_visibility": "DEFAULT", "callback_permission_status": "ENABLED" }}'{ "success": true}