How to Add Leads
Leads can enter your portal in eight ways. The first four happen inside PartnerPortal; the rest bring leads in from your website, your other tools, or an AI assistant.
- A partner registers a lead from the Register Lead screen in their portal.
- A partner uses the public lead form — the same form, with no login, on a personal link that keeps the credit with that partner and user.
- You add a lead on a partner’s behalf from the Add Lead screen.
- You bulk import leads from a CSV file.
- A visitor converts on your website after arriving through a partner’s affiliate link.
- A Zap creates a lead from a form, a CRM, or any other app.
- Your own code creates a lead through the Public API.
- An AI assistant registers a lead on your instruction.
Every one of these feeds the same lead record and the same pipeline: review or auto-approval, CRM sync, phases, commissions. The first four use the lead registration form you tailor to your program — see How to Customize the Lead Registration Form.
Partners register their own leads
Section titled “Partners register their own leads”Partners submit their own leads from the Register Lead screen in their portal (via Leads → Register Lead, or the Register Lead quick action on their dashboard). They complete the lead registration form you’ve set up, then submit.
Every lead a partner submits also appears in their own portal, so partners can see all the leads they’ve registered along with each lead’s current status (Pending, Approved, Active, Declined, or Expired).
Public lead form for partners
Section titled “Public lead form for partners”The public lead form is the same registration form, hosted on your portal’s own domain at https://your-portal.partnerportal.io/lead (or your custom domain), that a partner can open and fill in without logging in. It exists to reduce friction: a partner user can register a lead from any device without signing in first, and a partner organization with a large team and only a few portal accounts can let the rest of the team register leads too.
Each partner user has their own link to the form, with their personal code at the end: https://your-portal.partnerportal.io/lead?ref=a1b2c3. That code is what keeps attribution right. A lead submitted through a user’s link is credited to that user’s partner organization and registered by that user, exactly as if they had logged in and filled in the form. Partners must use their own link, not a colleague’s or a generic address, or the lead lands under the wrong name. There is no form without a code; a link with no code, or an out-of-date one, shows a “not available” message.

The form shows the fields you build under Leads -> Configure Lead Registration Form: the same fields, in the same order, with the same placeholders, required marks and picklist options the logged-in Register Lead page shows. If a field is limited to certain partner groups, the form shows it only for partners in those groups. Fields that point at your own pipeline values, such as a Close Value field, are never shown.
Turn it on
Section titled “Turn it on”The form has its own card on the Leads settings page, below the lead form fields it renders. It is off by default.
Open Leads -> Configure Lead Registration Form and scroll to the Hosted Lead Form card. Click Edit.
Turn the switch on.
Optionally set the Text above the form and the Text after submitting. Leave either blank for a standard sentence that names your portal.
Click Save.

Where partners find their link
Section titled “Where partners find their link”Partners find their link in a card at the top of their Register Lead page, with a copy button. The link is generated the first time the page is opened, and the card is hidden until you turn the form on.

To hand out a partner’s link yourself, open the partner’s page: a Lead Form Links card lists the links of every active user at that partner, owner first, each with a copy button. The owner’s link is the one to share when leads should be credited to the partner as a whole; a lead that arrives through a team member’s link is registered by that team member, so it shows in their own lead list.
What happens to a form lead
Section titled “What happens to a form lead”When the form is submitted, PartnerPortal creates a lead in your portal:
- it is credited to the partner whose link was used, and registered by the user whose link it was (if that user has since left the partner, the lead goes to the partner’s owner or first active team member instead)
- it follows your lead settings exactly as a lead registered by a logged-in partner would. If you require admin review, the lead starts locked. If you auto-approve new leads, it is approved on arrival, and if you also auto-sync approved leads to your CRM, the deal is created there.
- duplicate detection runs on it, so a form lead for a company another partner already registered is flagged for your review
- it shows Public Form as its origin on the lead’s detail screen
- every required field on your form must be filled in; a submission missing one is refused with a message naming the field
Two submissions for the same person create two leads, as two in-app registrations would; duplicate detection flags the second when it is on.
Add a lead on behalf of a partner
Section titled “Add a lead on behalf of a partner”As a portal owner, you can add a lead for a partner directly from the Add Lead screen (open Leads in the sidebar, or use Add New Lead on the All Leads tab). Fill out the lead registration form, then assign the lead using the Partner dropdown.
The dropdown lists every partner company currently in Active status. After selecting a partner company, choose the specific team member to associate with the lead.

If a partner doesn’t appear in the dropdown, their account isn’t Active — typically because they:
- Haven’t completed registration
- Are still in Pending status
- Have been Declined
- Have been Suspended
Bulk import leads
Section titled “Bulk import leads”On the Add Lead screen (Leads in the sidebar), use the Looking to bulk import leads? link at the top of the form.

You can also start an import from the All Leads tab — click Register Lead and select Import CSV.

In the import window, use Download the template to get our CSV template, or prepare your own. We only support CSV (comma-separated values) files, and your CSV must contain all of the required fields on your lead registration form.

Click Select CSV File, choose your file, and click Import Leads. The system uploads the file and checks for missing information in required fields, marking any it finds as errors (optional fields won’t flag errors). If errors are found, the file won’t import any leads until they’re corrected.
Once the file is clean, import it again. If no errors are found, you’ll see a success message. All imported leads are placed in Pending and require admin approval. Refresh your portal to see the new leads.
Finding Partner and Partner User IDs
Section titled “Finding Partner and Partner User IDs”Bulk import requires the Partner and Partner User IDs so each lead is linked to the correct partner.
As an admin: go to the All Partners tab and select the partner. Their unique ID appears in the partner details.

To associate a lead with a specific person on the partner’s team, scroll to the Partner Users section at the bottom of the partner’s page and copy the individual user’s ID.

You can also find a user’s ID by clicking the pencil icon to edit that Partner User.

As a partner: go to the Team tab under Account. Each user’s unique ID appears next to their name in the ID column. If you’re importing leads for yourself, use your own ID.

Affiliate links
Section titled “Affiliate links”With affiliate links, every partner user gets a personal link to your website. A small script on your site remembers which partner sent each visitor, and when that visitor books a demo, fills in a contact form, or signs up, PartnerPortal creates a lead for that partner automatically. Nothing is registered by hand: the visitor’s own form submission becomes the lead.
Affiliate leads always start Pending and are never auto-synced to your CRM, whatever your other settings, because they come from an anonymous visitor on your website. Setup, the tracking script, form mapping and the traffic report are covered in How Affiliate Links Work and How to Set Them Up.
Zapier automations
Section titled “Zapier automations”Zapier can create a lead in your portal from almost any other app: a form tool, a spreadsheet, your CRM, a chat message. You build a Zap whose trigger is the event in the other app and whose action is PartnerPortal’s Create Lead, mapping the trigger’s fields onto your lead fields and naming the partner the lead belongs to. Zapier can also update leads, add comments and look leads up, so a Zap can keep the record moving after it is created.
See Create a lead using Zapier for the step-by-step, and the rest of that page for the other lead actions.
API endpoints
Section titled “API endpoints”Your own systems can create leads directly through the Public API, with an API key from your portal. A lead created this way is recorded like any other, against the partner and partner user you name in the request, and with that partner’s commission terms applied. The same API lets you read, update and list leads, so it suits both a live feed from your product and periodic backfills.
See Create a lead in the Public API guide, and Developer Documentation for how API access, webhooks and Zapier fit together.
AI assistants and Claude
Section titled “AI assistants and Claude”If you have connected an AI assistant such as Claude to your portal, you can ask it to register a lead in plain language: “Register a lead for Acme Consulting: Jane Doe at Initech, [email protected].” The assistant uses your own permissions, confirms the details, and records the lead exactly as a portal registration, with the partner’s commission terms applied automatically.
See Using AI With Your Partner Portal for what the assistant can do, and How to Connect Claude to Your Partner Portal to set it up.
International phone numbers
Section titled “International phone numbers”The phone field on the lead registration form is a structured phone input with a country selector alongside the number box. Whoever fills in the form picks a country, or types a number with a leading + country code, and the value is stored in one standard international format (E.164, like +14155551234), so it maps cleanly onto your CRM’s phone fields. On the partner-side form the selector starts on the partner’s own country when PartnerPortal knows it.
Whether the phone field appears, and whether it’s required, is controlled per portal on the Leads settings page. See How to Customize the Lead Registration Form.