Setup guide

How to set up ping-post lead buying.

The setup starts with your buying rules and ends with an accepted lead in the right sales queue. Use this checklist with your lead-platform administrator and source partner.

The practical answer

Agree on the lead definition, obtain the buyer’s posting specification, map fields and responses, test both success and failure, then reconcile the first accepted leads against your CRM. Platform-specific instructions take precedence over generic examples.

1. Write the buying specification first

List the verticals, products, service areas and required fields. Set a clear boundary between a homeowner inquiry and a booked appointment. Assign an owner for changing geography, caps and price rules.

Write down which event is billable and how a disputed record is reviewed. A program is difficult to reconcile when one side counts an accepted ping and the other counts a completed post.

  • Accepted project types and exclusions.
  • ZIP list, branch routing and receiving hours.
  • Daily or other agreed purchase caps.
  • Exclusivity and duplicate handling.
  • Required source, timestamp and consent fields.
  • Billable event, review reasons and dispute process.

2. Obtain the actual buyer posting documents

Your platform or technical team should provide the exact endpoint, method, authentication approach, required fields and sample responses. Source-specific instructions matter: two buyers on the same platform can use different fields and rules.

Ask for a test mode or test destination and a safe way to exchange credentials. A link to a platform homepage is not a posting specification. Do not expose credentials in a query string shared in public, a website form or a downloadable example.

3. Map fields without silently changing their meaning

Create a source-to-buyer field map. Confirm names, types, accepted values and whether a missing value is allowed. An empty project-size answer should remain unknown; it should not turn into a value that happens to pass the buyer’s filter.

Preserve a stable source lead ID through the entire transaction. Use a documented timestamp format and timezone. Normalize phones and addresses consistently, while retaining enough context to investigate mismatches.

Field groupWhat to agree
IdentityStable lead ID and any buyer-issued transaction reference
MarketZIP formatting and state or branch identifiers
ProjectTrade, service, size and accepted enumerations
ContactRequired contact fields and normalization
EvidenceCapture time, source identifiers and required certificate fields
DeliveryBid reference, expiry and final acceptance response

4. Treat responses as business decisions

An HTTP 200 response only describes the HTTP request. The response body may still reject the lead. Parse the agreed business status and save its reason code instead of marking every successful network call as a purchase.

Define what happens when a request times out after the buyer has already received it. A blind retry can create a duplicate record or charge. Use the platform’s supported idempotency or duplicate-reconciliation mechanism and ask how to query an uncertain result.

5. Test the cases that break in production

Use synthetic records that the receiving team recognizes as tests. Test a valid transaction and deliberate failures. Keep evidence of the response and the downstream record for each case.

Also test a pause or cap change while traffic is being evaluated. A buyer’s availability can change between a ping and a post. The specification needs to explain that race, not just the ideal path.

  • Valid ping followed by an accepted post.
  • Wrong ZIP or project type.
  • Missing required field and an unsupported field value.
  • Duplicate lead and repeated request.
  • Cap reached and source paused.
  • Expired or invalid transaction reference, where used.
  • Timeout, rate limit and unexpected response.
  • Accepted lead visible in the intended CRM queue.

6. Reconcile a controlled pilot

Start with an agreed market and capacity limit. Compare source transaction logs, buyer acceptance and CRM creation before increasing volume. If the counts disagree, investigate the missing IDs rather than assuming an attribution delay.

Document a pause contact and escalation path. After the delivery path works, use contact and appointment feedback to review the lead specification. More traffic does not fix a mapping error.

Interactive worksheet

Is your receiving workflow ready?

Check what you have in place. This worksheet stays in your browser and contains no homeowner data.

0 of 8 items ready

Questions buyers ask

Before we get started.

Can I use the same payload for every buyer?

No. Reuse a field-map process, not an assumed payload. Each buyer’s specification controls required fields, accepted values, authentication and response parsing.

Do I need to build a custom API?

Not necessarily. Existing lead-management platforms can provide receiving and routing functions. Whether a custom service is needed depends on your platform, data requirements and downstream systems.

What should I send Adsora before a setup call?

Send the platform name, requested verticals, markets and volume. Indicate whether posting documentation is available. Arrange a secure exchange for actual credentials and test records afterward.

Source documentation

Implementation details can vary by account and change over time. Use your current posting specification alongside these provider documents.

Your next lead source

Put the guide to work in your lead program.

Already receiving leads or building your first workflow? Tell us your verticals, markets and setup.

Discuss your lead program