Resolve Senders

curl -X POST 'https://comms.twilio.com/preview/Senders/Resolve' \
--header 'Content-Type: application/json' \
--data '{
    "recipientAddresses": [
        { "address": "+14153902337", "channel": "PHONE" },
        { "address": "davidpletnjov@example.com", "channel": "EMAIL" }
    ]
}'\
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

{
  "results": [
    {
      "from": {
        "senderId": "comms_sender_01h9krwprkeee8fzqspvwy6nq8",
        "displayName": "Customer Support",
        "channel": "SMS",
        "address": "+15035551234"
      },
      "to": {
        "address": "+14155552671",
        "channel": "PHONE"
      },
      "priority": 0
    },
    {
      "from": {
        "senderId": "comms_sender_01h9krwprkeee8fzqspvwy6nq8",
        "displayName": "Customer Support",
        "channel": "WHATSAPP",
        "address": "+15035551234"
      },
      "to": {
        "address": "+14155552671",
        "channel": "WHATSAPP"
      },
      "priority": 1
    },
    {
      "from": {
        "senderId": "comms_sender_01h9krwprkeee8fzqspvwy6nq9",
        "displayName": "Customer Support",
        "channel": "EMAIL",
        "address": "support@example.com"
      },
      "to": {
        "address": "jane.doe@example.com",
        "channel": "EMAIL"
      },
      "priority": 2
    }
  ]
}

This operation resolves a list of eligible Senders for sending and receiving communications for the given criteria.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Request

This endpoint expects an object.

ResolveSendersFromSenderPoolRequestobjectRequired

ResolveSendersFromAddressesRequestobjectRequired

Response

resultslist of objects

An array of compatible Sender-Recipient pairs to communicate from and to. Limited to the top 10 highest priority results.

Errors

400

Bad Request Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error