Learning Objectives:
- Understand what Submission Instructions are and how they function.
- Know how to access them and what information each section provides.
- Learn how each section helps providers submit leads successfully.
Overview
Summary:
Submission Instructions are auto-generated posting guidelines in LeadConduit that tell lead sellers exactly how to submit lead data to a specific flow.
Why It Matters?:
Each LeadConduit source has its own Posting URL, supported fields, acceptance rules, and recommended submission methods. Submission Instructions simplify onboarding for sellers, reduce delivery errors, and ensure leads are formatted correctly. They also include interactive examples that show sellers precisely what successful submissions look like.
In practical terms, Submission Instructions act as the recipe for sending leads: they outline what data to provide, how to format it, where to send it, and what determines success or failure.
Context & Background
Submission Instructions are automatically generated for each source that represents a seller in a LeadConduit flow. They ensure that all sellers receive accurate, source-specific rules without requiring custom documentation. They dynamically update based on the buyers flow settings.
Why It Exists?
Without centralized, accurate posting instructions, sellers would frequently deliver incorrectly formatted data, leading to failures. Submission Instructions consolidate everything a sellers needs into one place — including fields, methods, criteria, and examples.
Key Elements Found in Submission Instructions
At the top right of the page is a Share button and an Import Leads button for the leads provider to get started. Before they do that, though, they should review the individual sections on this page, as there is important information about what is accepted, how it is accepted, etc. These sections are hyperlinked on the left under “Table of Contents”, so clicking on a section header will jump them directly to that section.
Overview Section
Explains how to use the Submission Doc and who to contact if issues arise. Provides introductory context for new providers.
Submission URL
Displays the unique Posting URL for the customer’s specific LeadConduit flow. This is where the provider must send all lead data.
Fields
Lists all fields the flow will accept, including example values. These come directly from the flow configuration and reflect exactly what the provider may submit.
Acceptance Criteria
Explains the rules the flow uses to determine whether a submission is considered a “success.” If the submission does not meet these criteria, LeadConduit returns a failure response.
HTTP Method
Describes how providers can submit leads, including GET or POST (POST is recommended), and supported formats such as JSON or XML. It also shows what success, failure, and error responses look like in each selected format. Selecting a method in the dropdown dynamically updates the examples shown.
How to Redirect
Provides a redirect URL for customers generating first-party leads on a webform. When the form submits, users can be routed to a specific page (confirmation, thank you, offer page, etc.).
Interactive Examples
Allows the provider to:
- Select an HTTP method
- Choose test data
- Generate an example request and response based on that method
The tool creates real, syntactically correct examples so providers can confidently test lead delivery.
Practical Examples
Example 1 — Accessing Submission Docs for the First Time
A first-time user attempting to open third-party Submission Docs is prompted to log in or create a free account. Once authenticated, they are automatically redirected to the correct documentation.
Example 2 — Reviewing Acceptance Criteria
A lead provider examines the Acceptance Criteria section to learn what conditions must be met for LeadConduit to consider the lead a success. Missing or invalid information results in a failure response.
Implications & Applications
Key Takeaways:
- Submission Instructions ensure providers understand exactly how to submit leads.
- They include everything required to deliver leads correctly — URLs, fields, rules, methods, and examples.
- Reviewing all sections minimizes failed submissions.
Frequently Asked Questions (FAQ)
What are Submission Instructions used for?
They explain how to submit lead data properly to a specific LeadConduit flow.
Are Posting URLs the same across customers?
No. Every source generates its own unique Posting URL.
Can providers test their submissions?
Yes. The Interactive Examples section provides real-time example requests and responses.
What happens when criteria are not met?
The submission returns a failure response with details.
Glossary
| Term | Definition |
|---|---|
| Submission Instructions | Auto-generated posting docs that explain how to deliver leads to a specific LeadConduit flow. |
| Posting URL | The unique endpoint where a provider sends lead data. |
| Fields | The list of accepted fields and example values. |
| Acceptance Criteria | Rules determining whether a submission is treated as a success. |
| HTTP Method | GET, POST, JSON, or XML format used when sending leads. |
| Redirect URL | A destination web address used in first-party lead generation. |
| Interactive Examples | A tool that generates sample requests and responses based on selected inputs. |
Comments
0 comments
Please sign in to leave a comment.