How to Post Leads to Campaign

What "Post to Campaign" Means

Submitting a lead directly to a Campaign (as opposed to a Schedule) attaches the lead data to the Campaign for attribution purposes. A subsequent inbound call from the same caller ID will inherit the submitted data as Call tokens. Lead submission to Campaign does not trigger outbound dialing or any automated action.

Use this pattern when you want to enrich inbound calls with form data captured earlier in the funnel. For example, a user fills out a form on your landing page, then clicks the tracking number to call; the resulting Call carries the form fields as tokens.

Endpoint

POST / GET: /api/v1/leads/capture. Use the Campaign's leads_api_key (the Call Transfer Token) as the lead_token parameter.

Example

curl -X POST \
  "https://your-domain.com/api/v1/leads/capture?lead_token=OFFER_LEADS_API_KEY&caller_id=+1800001234&email=john@example.com&interest=kittens"

JSON form works identically to the schedule case, with the difference that the token belongs to the Offer rather than a Schedule.

When to Submit to a Schedule Instead

If TrackDrive should start calling or texting the lead automatically, submit to a Schedule token instead. See the companion article "How to Submit Leads via API" under Schedules.