v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-041,1941,9384.1 MB

Number Settings

Bulk update phone number profiles

post/messaging_numbers_bulk_updates

Request body

assign_onlyboolean

If true, only assign numbers to the profile without changing other settings.

messaging_profile_idstring required

Configure the messaging profile these phone numbers are assigned to:

Set this field to "" to unassign each number from their respective messaging profile
Set this field to a quoted UUID of a messaging profile to assign these numbers to that messaging profile

numbersstring[] required

The list of phone numbers to update.

Example request

{
  "messaging_profile_id": "00000000-0000-0000-0000-000000000000",
  "numbers": [
    "+18880000000",
    "+18880000001",
    "+18880000002"
  ]
}

Response

Successful response with details about messaging bulk update phone numbers.

Example response

{
  "data": {
    "failed": [],
    "order_id": "00000000-0000-0000-0000-000000000000",
    "pending": [],
    "record_type": "messaging_numbers_bulk_update",
    "success": [
      "+18880000000",
      "+18880000001",
      "+18880000002"
    ]
  }
}