Skip to main content
PATCH

Path Parameters

string
required
The phone number ID. Format: pn_...

Body

All fields are optional. Only provided fields are updated.
string
Display name for this number (max 100 characters).
object
Webhook configuration for inbound and outbound SMS events.
object
Automatic reply sent to every inbound message.

Response

object
The updated phone number record. See Get Phone Number for the full response schema.
Webhook signing: When a webhook endpoint is set, Commune sends an X-Commune-Signature header with each request. The signature is an HMAC-SHA256 of the request body using your webhook secret. Verify this header on your server to confirm the request is authentic.
Auto-reply credits: Each auto-reply consumes the same credits as a regular outbound SMS (2 credits per segment for US numbers).
Last modified on March 19, 2026