Skip to the help topics

How can we help?

Guides for publishers and buyers: sending calls, the API, ping and post, results and billing.

Getting started

#How a call moves through CallsPixel

CallsPixel connects people who have callers (publishers) with companies that buy those calls (buyers).

  1. A publisher has a customer on the phone, or a customer calls a publisher's number.
  2. The publisher tells CallsPixel about the caller: through the agent form, the Publisher API, or simply by dialing the transfer number.
  3. CallsPixel checks the caller (DNC, state, hours, limits) and asks the buyers. Buyers with a fixed number and buyers that bid live compete in one order.
  4. The call goes to the buyer who takes it. If that buyer does not answer, the next buyer is tried automatically.
  5. The buyer sends a result (billable, sale, rejected). Publishers are paid and buyers are billed from those results.
Publishers never see buyer names, bids or buyer numbers. Buyers never see which publisher sent the call.
Back to top

#Account types

#Publisher

Sends calls. Has a login with live calls, leads, agents, billing and (when switched on) the API documentation.

#Agent

Works for a publisher. Uses a personal agent form link, no password needed. See Using the agent form.

#Buyer

Takes calls. Has a buyer portal with leads, bids, reports, billing, claims and the result API. See Ways to buy calls.

#Broker

Manages a group of publishers and sees their live calls, leads and billing.

Back to top

#Words we use

  • Vertical: the kind of call, for example Medicare, ACA or auto accident.
  • Campaign: one offer inside a vertical, with its own buyers, publishers, states, hours and limits.
  • CPL: the buyer pays per qualified call (or lead).
  • CPA: the buyer pays only per approved sale.
  • Ping: a question to the buyers: "do you want this caller, and for how much?". No call is sent yet.
  • Post: confirming the call after a ping was accepted.
  • Bid: the amount a buyer offers in its reply to a ping.
  • Transfer number: the number you dial to send the caller. It is always a CallsPixel number, never the buyer's.
  • Caller ID: the customer's phone number. It must be shown when you transfer, so the system knows which customer is calling.
  • Buffer: on CPL, a call becomes billable once it lasts this many seconds.
  • Cap: a daily or monthly limit of calls.
  • Concurrency: how many calls can be live at the same time.
  • DNC: do not call list.
Back to top

For publishers

#Your account and agents

#Logging in

Your manager sends you an invitation by email. Open it, set your password, and log in on the home page.

#Adding agents

Open Agents in your menu and add each agent. Every agent gets a personal form link. Calls and reports then show the agent's name.

#What you see

  • Live calls: calls happening now and today's calls.
  • Leads dashboard: every lead with its result (Pending, Billable, Approved, Rejected).
  • Billing: what you earned and your invoices.
  • API documentation: only when the Publisher API is switched on for you.
Back to top

#Using the agent form

The agent form is the fastest way to send a call without any development.

  1. Type the customer's phone number. The form checks it at once: DNC and the customer's state.
  2. Fill in the customer details: name, state and zip. Some campaigns ask for more (for example date of birth). Those fields appear by themselves when a buyer needs them.
  3. Press Submit. The buyers are asked right then, with the details you typed.
  4. Read the answer on the screen:
  • "✅ A buyer accepted. Transfer the call to …": transfer the call to that number now.
  • A buyer web form: see When a buyer web form is needed.
  • "No buyer available": no buyer can take this customer right now. Do not transfer.
  1. Transfer the call with the customer's number as caller ID. The screen then shows the call status: calling, connected, finished.
The number shown is always your CallsPixel transfer number. Use the one on the screen.
Back to top

#Transferring the call

#The caller ID rule

When you transfer, the caller ID must be the customer's phone number, the same number you typed or sent. That is how CallsPixel matches the call to the customer and to the buyer who accepted. A call with a different caller ID cannot be matched.

#Time to transfer

After a buyer accepts, transfer within about 15 minutes. After that the deal expires and the buyers are asked again when the call arrives.

#When the buyer does not answer

If a buyer is busy, does not answer, or hangs up within 20 seconds while your customer is still on the line, CallsPixel tries the next buyer by itself, up to 8 buyers. A buyer that refused the customer is not tried again on that call.

Back to top

#When a buyer web form is needed

Some buyers only take customers through their own web page. When no other buyer takes the customer, the agent form shows these buyers instead of the transfer number.

  1. Each buyer shows Open ping page ↗ and/or Open posting form ↗. They open in a new tab.
  2. Fill in and submit the customer on that buyer's page.
  3. Come back and press ✓ I submitted for this buyer.
  4. The transfer number appears. Transfer the call: it goes only to the buyer you chose.
Back to top

#Publisher API: overview

The Publisher API is for developers who send calls from their own system or web form.

#Your access

Your personal API documentation is in your login, under API documentation. It shows:

  • your API key (keep it private; send it as the X-Api-Key header),
  • your pub_id,
  • every vertical and campaign you are allowed, with their IDs,
  • every parameter you must send, with its exact name,
  • your own transfer number.

#Address

All requests go to:

https://www.callspixel.pro/publisher_api.php

#The flow

  1. Ping: send the caller's details. You get an answer and a ping_id.
  2. Post: confirm within 60 seconds. You get the transfer number.
  3. Transfer the call with the customer's number as caller ID.

Or send everything in one request: Post only.

Back to top

#Publisher API: ping

Send vertical_id. CallsPixel checks every campaign of that vertical you are on and picks the best one for this caller. The reply tells you which campaign_id was used.

#Ping by campaign

Send campaign_id when you want one campaign only.

#Example

curl -X POST "https://www.callspixel.pro/publisher_api.php?action=ping" \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"pub_id":"PB4F7K2Q","vertical_id":"VT8M3D1X","caller_id":"4805550121","first_name":"John","last_name":"Smith","state":"AZ","zip":"85281"}'

#Reply

{"ok":true,"accepted":true,"ping_id":"a1b2c3...","payout_model":"cpl","payout":12.5,"expires_in":60}
Back to top

#Publisher API: post and transfer

After an accepted ping, post within 60 seconds with the ping_id (and any post fields your documentation lists).

curl -X POST "https://www.callspixel.pro/publisher_api.php?action=post" \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"ping_id":"a1b2c3..."}'

#Reply

{"ok":true,"accepted":true,"transfer_number":"480-555-0199","caller_id_required":"4805550121","expires_in":900,"reference":"f9e8d7...","payout_model":"cpl","payout":12.5}

Dial transfer_number within expires_in seconds, with caller_id_required as your caller ID. Keep reference to match the call in your reports.

Each ping can be posted once. A ping older than 60 seconds must be sent again.
Back to top

#Publisher API: post only

If you do not need the price first, skip the ping. Send every parameter (ping and post fields) in one request to ?action=post without ping_id. CallsPixel asks the buyers and answers with the same reply as a post.

Back to top

#Parameter names and test mode

#Exact names only

Send each parameter with the exact name in your documentation, for example caller_id for the customer's phone number. A different name (like phone or callerid) is not read, and a missing required parameter is refused with its name.

#Which parameters

Your documentation lists them per vertical, with Required yes or no. The list follows the buyers that are active for you: if a buyer needs an extra detail and you do not send it, only that buyer is skipped and the others can still take the call.

#Test mode

Add "test": true to any ping or post. Your parameters are checked and the answer tells you what is wrong. No buyer is contacted.

Back to top

#Replies, reasons and errors

#Not accepted: reasons

The request was fine but no buyer took the caller. The reply has accepted: false and one of these reasons:

reasonMeaning
no_buyerNo buyer can take this call right now
repeat_pingThis caller was just pinged. Wait before pinging the same caller again
bad_phoneThe number is not a valid US number
blockedThe number is blocked (opted out or on a do-not-call list)
daily_cap_reachedYour daily limit for this campaign is reached
no_number_availableAll your transfer numbers are in use. Wait a moment and post again
no_tracking_numberYour account has no transfer number yet; contact your manager

#Errors

The request itself was refused. Fix it and send again:

errorMeaning
invalid_keyThe API key is wrong or was regenerated (401)
pub_id_mismatchpub_id is not the publisher of this API key (403)
ip_not_allowedYour server IP is not on the allowed list (403)
account_pausedYour account is paused (403)
campaign_not_availableYou are not on this campaign, or it is off (403)
vertical_not_availableYou have no campaign in this vertical (403)
invalid_fieldsA parameter is missing or wrong; see "fields" in the reply (422)
rate_limitedToo many pings this minute (429)
unknown_pingThat ping_id does not exist for your key (404)
ping_expiredThe ping is too old; ping again (410)
ping_already_usedEach ping can be posted once (409)
Back to top

#Payouts: CPL and CPA

Every accepted ping and post tells you how this call is paid:

payout_modelWhat you get
cplpayout is paid for the call when it qualifies.
cpapayout is 0: nothing is promised for the call. You are paid only if the buyer approves the sale.

#CPL

You earn the payout when the call qualifies (for example when it lasts long enough).

#CPA

Nothing is promised when the call is sent. You earn only if the buyer approves the sale. Your leads show Pending until the buyer's result arrives, then Approved or Not approved.

Back to top

#Live calls, leads, claims and billing

#Live calls

Every call you sent today, live, with its status and length.

#Leads dashboard and results

Each lead shows its result: Pending, Billable / Approved, Not billable / Not approved, Returned or Duplicate.

#Claims

If a buyer rejected a call you believe was good, you can file a claim within 5 days of the rejection, with the recordings. The buyer reviews it and marks it Billable or Rejected.

#Billing

Your earnings, invoices and payments. Pending leads are not money yet: they count only once a result makes them billable.

Back to top

#DNC scrubber

When it is switched on for you, DNC scrubber in your menu checks a list of numbers against the do-not-call lists before you dial them. Upload a file or paste numbers; download the clean list.

Back to top

For buyers

#Ways to buy calls

  • Fixed number: every call goes to your phone number. Simple, no development.
  • Ping / post: CallsPixel asks your system about each caller first. You accept or refuse, and can give a price and your own number per call. See Ping and post.
  • Live bid: like ping / post, and your bid competes with other buyers on price.
  • Post only: you receive the caller's details once and answer yes or no.
  • Your own web form: publishers' agents fill your form, then transfer the call to you. See Web form buyers.

You can combine limits on any of them: hours, states, daily and monthly caps, and how many calls at once.

Back to top

#Ping and post: what we send you

#Your format, your names

Give us your API documentation. CallsPixel sends each ping (and post) to your address in your format: JSON, form or query string, GET or POST, with your parameter names, fixed values and keys. Phone numbers can be sent as 10 digits, 11 digits, +1 format or with dashes.

#What can be sent

The caller's phone number and state are always available. Name, zip, and any detail of the vertical (for example date of birth) are sent when your setup needs them. A reference ID is sent so you can report the result later.

#Speed

Answer quickly: callers are waiting. A ping that does not answer in time counts as a refusal for that caller.

Back to top

#Your reply: accept, bid, number and length

CallsPixel reads your reply in JSON, XML or plain text. We set up where each value is, for example:

{"accepted": true, "bid": 42.50, "number": "+15125550199", "duration": 90}
  • Accepted or not: a field or word that says yes (or the presence of a number).
  • Bid / payout (optional): the price for this call. Without it, your fixed price is used.
  • Number (optional): the number to send this call to. Without it, your fixed number is used.
  • Duration (optional): how many seconds make the call billable.
  • Reason (optional): why you refused. It helps us fix problems faster.

#Number valid for a short time

If the number you return only works for a short time, tell us how long. If the call comes after that, CallsPixel asks you again for a fresh number.

#Refusing is fine

A refused caller is never sent to you on that call, and the next buyer gets it.

Back to top

#Web form buyers

If you take customers only through your own web page, give us its link (and your ping page link if you have one). When no other buyer takes a customer, the publisher's agent opens your page, submits the customer there, then transfers the call. That call goes only to you.

Back to top

#Sending results

Results decide what you are billed and what publishers earn. You can send them two ways.

#1. Upload your report

Open Upload report in your portal and upload your billing file. It is matched to your leads.

Your keys are in your portal under API. Send the reference (or the phone number) and the result:

1. Send a result by link

Call this link from your system, by GET or POST. Replace the values in brackets.

https://www.callspixel.pro/buyer_api.php?token=YOUR_RESULT_TOKEN&reference=[reference]&result=[result]&amount=[amount]

2. Send a result with the API key

curl -X POST "https://www.callspixel.pro/buyer_api.php?action=result" \
  -H "X-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"reference":"abc123","result":"accepted","amount":45.50}'
FieldMeaning
referenceThe reference we sent you with the lead. call_id also works.
phoneUse if you have no reference. It finds your newest lead for that number in the last 30 days.
resultaccepted, approved, billable, paid, sale, sold, converted, rejected, declined, not_qualified, returned, refund, pending
amountOptional. The final amount you pay for this lead.

You can correct a result until the lead is on an invoice.

3. Read your leads

curl "https://www.callspixel.pro/buyer_api.php?action=leads&from=2026-11-01&to=2026-11-16&status=all&limit=100&offset=0" \
  -H "X-Api-Key: YOUR_API_KEY"

Send the API key in the header. Results are newest first, up to 500 per request.

Errors

invalid_keyThe key or token is wrong, turned off or replaced (401)
reference_requiredSend a reference or a phone number (422)
unknown_resultThat result word is not on the list (422)
invalid_amountThe amount must be a number from 0 to 100000 (422)
lead_not_foundNo lead of yours matches (404)
already_invoicedThe lead is on an invoice, so it can no longer change (409)
under_reviewThe lead is marked as a duplicate or is under review (409)
set_by_adminThe account manager set this result. Contact them to change it (409)
rate_limitedToo many requests. Wait a minute and try again (429)
Back to top

#Billing: CPL and CPA

#CPL

You pay per qualified call. A call can become billable by your result, or by the call length (buffer) agreed with you.

#CPA

You pay per approved sale only. A call is billed once you mark it as a sale.

#Invoices

Your invoices and payments are in Billing. A result can be corrected until the lead is on an invoice.

Back to top

#Your buyer portal

  • Dashboard: today at a glance.
  • My leads: every call or lead you received, with its result.
  • Claims: a publisher disputing your rejection sends you the recordings; mark it Billable or Rejected.
  • My campaigns: what you are set up to take: status, hours, caps and how much of each cap is used.
  • Bids: your own pings, bids and wins (ping / post and live bid buyers).
  • Report: leads, billable, rejected and awaiting, per day and per number. CSV download.
  • Billing, API and Upload report.
Back to top

Rules and compliance

#DNC and opt-outs

Every number is checked against the do-not-call lists before it reaches a buyer, and against each buyer's own DNC checker when the buyer has one. A blocked number is refused with the reason blocked, and the caller is never sent.

Back to top

#Duplicates and repeat callers

A caller sent to the same buyer again within the buyer's duplicate period is marked Duplicate and is not billed. Pinging the same caller again too soon is refused with repeat_ping.

Back to top

#Hours, states, caps and calls at once

Each buyer can limit its hours, states, daily and monthly caps, and how many calls it takes at once. Publishers can also have a limit of calls at once. When a limit is reached, the caller goes to the next buyer, or is refused with a reason.

Back to top

Troubleshooting

#"No buyer available"

No buyer can take this caller now. Common causes: outside buyers' hours, a state no buyer takes, caps reached, or every buyer refused this caller. Try another caller; do not transfer this one.

Back to top

#The call did not reach the buyer

  • Check the caller ID: it must be the customer's number. See Transferring the call.
  • Check the time: transfer within about 15 minutes of the accept.
  • Dial the transfer number shown on the screen or in the post reply.
Back to top

#"invalid_fields" from the API

A parameter is missing or has the wrong name. The reply lists it, for example {"fields":{"caller_id":"is required"}}. Use the exact names in your API documentation, and check with "test": true before going live. See Parameter names and test mode.

Back to top

#"ping_expired" or "ping_already_used"

Post within 60 seconds of the ping, and post each ping_id only once. Otherwise ping again.

Back to top

#Why is my lead not billable?

  • CPL: the call was shorter than the buffer, or the buyer rejected it.
  • CPA: the buyer has not approved a sale yet (Pending), or did not approve it.
  • Duplicate: the same caller reached the same buyer again within the duplicate period.

If you think a rejection is wrong, file a claim. See Live calls, leads, claims and billing.

Back to top

Still need help?

Contact your account manager, or: