Skip to main content
PUT

Path Parameters

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

Body

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

Response

object
The updated phone number record with the new blockList. See Get Phone Number for the full response schema.
Block list behavior:
  • Numbers on the block list are always denied, regardless of whether they also appear on the allow list.
  • Block list wins over allow list when a number is on both.
  • Blocked inbound messages are still stored with delivery_status: "blocked" for your audit trail, but your webhook is not fired and no credits are charged.
This is separate from the STOP/opt-out suppression system. The block list is admin-controlled. The suppression list is populated by recipients replying STOP.
Last modified on March 19, 2026