Submitting leads into LeadByte


This article aims to give you a basic understanding of how you can submit leads into your LeadByte account.



LeadByte supports 3 methods of lead submission - 

  1. Classic GET API
  2. Optimised REST API
  3. CSV Import


The Classic GET API utilises a GET or Form POST in order to submit leads to LeadByte.

This option has no API key and processes leads without a queue function.

As a result, it's not the best choice for high volume.


The REST API utilises a JSON POST in order to submit leads to LeadByte.

This uses a REST API key and adds leads to a queue to be processed.

This is a more secure and a more optimised option, especially for large volumes


The Import function is for uploading leads in bulk.

As an example - think adding a "do not call" list from your buyer.


When should I use each API option?

Ultimately, what your form, website or suppliers can handle will determine which option you use but the below should guide you into an informed decision if you have multiple options.


We would recommend you utilise the REST API where possible as it's the more robust option and will be less susceptible to duplicates slipping through. More reading about this here - Campaign Deduplication.


Because the classic API processes leads immediately you will be provided with a Lead ID OR a rejection reason upon submission.

The REST API can still reject leads immediately, but it will provide a "Queue ID" instead of a lead ID. 

Once a queue ID is provided, the lead can still be rejected as further validation is still to be done.

As an example, a lead can pass basic validation (syntax checks, duplicate checks etc) but still fail live validation services such as HLR. More reading about this here - Using the QueueID via REST API.


Would you like to feed the sold status of a lead back to your supplier? Or use a custom thank you page to detail who a lead has been sold to? Then the REST API is the choice for you! - Live Buyer Responses


Further reading -

We have more details articles about using these features linked below - 

Classic API - Submitting leads via the Classic API

REST API - Submitting Leads via REST API

CSV Import - How to Import to add/update/return leads


As always, if you have any questions please don't hesitate to raise a support ticket.

Was this article helpful?
0 out of 0 found this helpful