InboundXPublisher docs

On this page: With the ping (the usual way)

Advanced · Reference

Your call ID

Your platform's own ID for a call. We send it back as {CALL_ID} in your postback, so your platform knows which call paid.

With the ping (the usual way)

Send it on every ping, under any of these names:

ringba-requestidringba_requestidrequest_idcall_idcallidsourcecallidsource_call_idtraceexternal_idclickid

After the call starts

Some platforms create their call ID only when the call reaches them. Send it to us then:

GETPOSThttps://app.inboundx.io/api/rtb/call-id
curl
curl -X POST "https://app.inboundx.io/api/rtb/call-id" \
  -d "key=YOUR_PING_KEY" \
  -d "caller_number=+15555550123" \
  -d "request_id=abc-123"

We find the call by the caller's number, so send the same number you pinged with.

Answers

Every answer is HTTP 200 with JSON.

StatusWhat it means
okAttached. The answer says whether we found the call itself or the bid still held for it: callreservation
no_matchWe found no recent call or held bid for that caller on this key. Check the number.
errorThe request itself was wrong. The answer says what: missing_keymissing_caller_numbermissing_request_idbad_caller_numberlookup_failedunknown_keypublisher_mismatch

The three answers look like this:

JSON
{"status":"ok","matched":true,"via":"reservation"}
{"status":"no_match"}
{"status":"error","reason":"missing_key"}

Without a call ID

A postback URL that uses only {PHONE} still works, but it can't tell two calls from the same caller apart. Send a call ID whenever your platform has one.

Your ping keys come from the buyer you send calls to. Ask them for a key, or for help with your setup.© InboundX