Add Lead URL: creating leads from inbound calls

When someone calls a number you have never heard from, the dialer often creates a fresh lead for them on the spot. Add Lead URL is the in-group field that lets you tell another system the instant that happens. It is a quiet background call to a web address, not something the agent sees, and it only runs when a genuinely new lead is born.

What triggers it

The trigger is narrow on purpose. Add Lead URL fires every time a Lead is added through the inbound process. If the caller's number already matches a record in the system, no new lead is created and this URL stays quiet. That makes it a clean signal for one thing: a first-time contact just reached you. If you want a hook for callers you already know, you would use one of the other in-group URLs instead, since those fire on every call rather than only on new ones.

The data you can send

To pass call details, start the URL with the letters VAR. That tells the system you want to use variables. Then, anywhere in the address, you wrap a variable name in the marker tokens it expects and the live value gets dropped in when the request goes out.

The variables available here are tailored to a new lead: lead_id, vendor_lead_code, list_id, phone_number, phone_code, the details of the DID (direct inward dialing) it came in on (did_id, did_extension, did_pattern, did_description), and uniqueid. So a single request can tell your system the new lead's database ID, the caller's number, and exactly which inbound number they dialed.

What you would do with it

The obvious move is creating a matching record in your own CRM the moment a new caller appears, so your sales or support tooling knows about them before the agent even finishes the call. Because you get the did_id and did_pattern, you also know which campaign or marketing source drove the call, which is great for attribution. A call that came in on your radio-ad number can be tagged differently from one on your website number, automatically. Over a month, that gives you a real count of how many fresh contacts each marketing channel produced, without anyone tallying it by hand.

There is a companion setting worth knowing: Add Lead Timezone controls how the system decides the new lead's time zone, either from the server clock or from the area code of the phone number. That matters if you ever plan to call these new leads back, since the time zone is what keeps you inside the hours you are legally allowed to dial. Get it wrong and you can end up calling someone at six in the morning their time, which is exactly the kind of mistake that draws complaints.

Add Lead URL is one of a family of in-group URL fields. For the rest of them and how they fit together, read the in-group URLs overview, and for the whole inbound picture see the inbound call handling guide.

Want a hosted dialer where new inbound leads can flow straight into your systems? See our plans.