Skip to main content
PUT

Path Parameters

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

Body

string[]
required
The complete allow list as an array of E.164 phone numbers (e.g., ["+14155559999"]). This replaces the entire current allow list. To clear the allow list and allow all numbers, pass an empty array [].All numbers must be valid E.164 format (e.g., +14155559999).

Response

object
The updated phone number record with the new allowList. See Get Phone Number for the full response schema.
Allow list behavior:
  • An empty allowList (default) means all inbound numbers are accepted (subject to the block list).
  • A non-empty allowList means only numbers on the list are accepted.
  • If a number appears on both the allow list and block list, the block list wins and the message is rejected.
Messages from blocked numbers are still stored with delivery_status: "blocked" for your audit trail.
Last modified on March 19, 2026