Sign in
Number Settings

Bulk update phone number profiles

Starts a bulk update of messaging-profile assignments for the supplied phone numbers. The response identifies the order used to monitor processing.

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"
    ]
  }
}

Changes

Changed in 2 of the 61 revisions of this API.7

  • 1571b0380bd73See the full diff
    • ▲

      the response's body type/format changed from object/ to / for status 4XX

      response-body-type-changed

    • ▲

      the errors/items/ response's property type/format changed from object/ to / for status 4XX

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from integer/int32 to string/ for status 4XX

      response-property-type-changed

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8f5f4e5379944See the full diff
    • ▲

      the response's body type/format changed from / to object/ for status 4XX

      response-body-type-changed

    • ▲

      the errors/items/ response's property type/format changed from / to object/ for status 4XX

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from string/ to integer/int32 for status 4XX

      response-property-type-changed

    • ▲

      the errors/items/source/pointer response's property type/format changed from string/json-pointer to string/ for status 4XX

      response-property-type-changed

    This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog