Routing to SIP and using SIP Headers

Routing Calls Via SIP Address

With Retreaver, you can route calls to SIP addresses and receive inbound calls via SIP.


Outbound SIP is done simply by changing the Buyer Phone Number to begin with sip: Once you begin typing this, the screen will change so that you can key in fields required to do outbound SIP. There are no changes needed to the Retreaver system to do outbound SIP, but it is important to know how the buyer will authenticate the calls via SIP to their system.

You may authenticate one of 3 ways

1) No authentication. (Just leave Username and Password Blank in Buyer Setup)
2) With Username and password.
3) By WhiteListing Twilio IP addresses. (Also leave Username and Password blank for this option)

For option 3, here is what your Buyer will need to know:

Signalling IPs to Whitelist

Port 5060 (UDP/TCP), 5061 (TLS)


In order to do inbound SIP to Retreaver, it will need to be set up manually so contact us at to get started.
Once you have those settings completed, you can begin setting up the inbound SIP.

For Inbound SIP, we require SIP authentication in one of 2 ways:

1) With Username and Password.
We give this to you during setup.
Example format:

2) By White Listing IP addresses where traffic will come from.
Send any lists from any source you need whitelisted to
Example format:
Any number you pull from the system can receive calls via SIP from any country. Just replace the +18882223333 with the phone number you want SIP calls to come in on. Don’t forget the country code!

Using SIP Headers

Calls to SIP-based Buyers automatically include several SIP headers in the INVITE request to the Buyer. These headers include X-PH-RetreaverUUID, the UUID for the call; X-PH-RetreaverKey, the postback key for the call; X-PH-RetreaverAFID, the publisher ID of the responsible Publisher; and X-PH-RetreaverSID, the sub_id of the responsible sub-affiliate if one is set.

Angela Dougherty

Client Success Officer