Skip to main content
Leads

Add Leads Manually

Add a single lead to an outbound campaign by hand: name, phone number, email and custom fields. Ideal for test calls and one-off contacts.

Written By voiceaiwrapper

Last updated 26 days ago

Adding a lead by hand is the quickest way to put one person into an outbound campaign. Use it to test your agent on your own phone before a launch, or to add a single contact who came in by email or a referral. It takes under a minute.

For more than a handful of contacts, import a CSV file or send leads through the API instead. See Import Leads from a CSV File and Add Leads Automatically with the API.

Before you start

You'll need:

  • An outbound phone campaign. The Add leads menu only appears on outbound campaigns. Inbound campaigns create their leads from the people who call in. See Create a Campaign with the Campaign Wizard.
  • A campaign that hasn't ended. On an ended campaign, Add leads is greyed out.
  • The lead's phone number, including the country.

Add a lead

  1. Open your Pod (an engine or provider connection) and select Campaigns in the sidebar.
  2. Open the outbound campaign, then open the Leads tab.
  3. Click Add leads, then choose Add leads manually. The Add New Lead sheet opens.
  4. Fill in the fields (see the table below). Only Phone Number is required.
  5. To add extra details, click Add Custom Field and enter a Key and a Value. Repeat for each detail. Click the X next to a row to remove it.
  6. Click Add Lead.
An outbound campaign's Leads tab with the Add New Lead sheet open on the right: First Name and Last Name filled in, a US number typed in Phone Number with the country flag picker visible, Email filled in, one custom field row (Key: company, Value: Acme Corp) and the Add Lead button at the bottom.

You'll see a confirmation message, and the lead appears in the table.

FieldRequiredWhat to enter
First NameNoThe lead's first name, for example John.
Last NameNoThe lead's last name, for example Doe.
Phone NumberYesPick the country from the flag menu (it starts on the US), then type the number. The webapp saves it in international format, such as +14155550123.
EmailNoA valid email address.
Custom FieldsNoAny extra details as key and value pairs, such as company = Acme Corp or appointment_time = 3pm.

Give custom fields short, consistent keys like company or last_order. The same keys then work across every lead, whether you add it by hand, by CSV or through the API.

If the number doesn't look right for the chosen country, the form shows This phone number is possibly invalid. It's a warning, not a block, so check the country and the digits before you save. If a call to a wrong number fails, the lead is marked Invalid and isn't called again.

Custom fields are passed to your agent with each call. If your agent's prompt uses a variable such as company, give every lead a custom field with that exact key.

What happens after you add a lead

  • The lead joins the campaign's queue. If the campaign is active and inside its calling window, the agent can call the lead right away. Otherwise the call waits until the campaign runs. See Set the Schedule and Calling Window.
  • Calls cost money. Calls on a VAW Native Pod use AI credits. Calls on a BYOK Pod (Vapi, Retell AI, ElevenLabs) are billed to your own provider account.
  • Your leads event webhook is notified. If the campaign has a leads event webhook, it receives a Leads Added event for this lead. See Leads Event Webhook.

To test an agent, set up the campaign, add yourself as the only lead, and start the campaign during its calling window. You'll get the same call your leads will get.

Edit or remove a lead

On the Leads tab, each row has three actions on the right:

  • View calls (eye icon) opens the Calls tab filtered to this lead.
  • Edit Lead (pencil icon) opens the same sheet. You can change the name, email and custom fields, then click Update Lead. The phone number can't be changed.
  • Delete (red bin icon) removes the lead after you confirm.

Deleting a lead also deletes all of its call logs and scheduled calls. This can't be undone.

To change a lead's phone number, delete the lead and add it again with the new number.

Troubleshooting

Each phone number can only be in a campaign once. Search the Leads tab for the number. If the existing lead was already answered and you want it called again, select it and use Bulk Actions β†’ Mark As Unanswered instead of adding a copy. See Bulk Actions on Leads.

The campaign has ended, so it no longer accepts leads. Add the lead to another campaign, or clone this one. See Clone, Edit and Delete Campaigns.

Add leads only appears on outbound phone campaigns. Inbound campaigns create their leads from the people who call in.

Check that the campaign is active and inside its calling window, and that the lead isn't marked Do not call. The lead's status tells you where it stands. See Lead Statuses Explained and My Outbound Campaign Isn't Calling.