Skip to main content
This guide runs one small outbound from start to finish. You find 20 people, get their work emails, write them a two-step email sequence, launch it and read who replied. Each step links to the guide that covers it in full.
You need an API key that can write (see Authentication) and one mailbox to send from. The whole run costs about $1.42 at most: $0.02 for the search, up to $0.40 for the emails found, and $1 for the mailbox’s first 30 days. Everything else here is free.
1

Find the people

Describe who you want. The search turns the description into filters and answers with the people and those filters:
A search costs $0.001 for each person it returns, so this page costs $0.02 at most. The X-Charged-Usd header on the answer says what it cost. Check unresolvedCriteria in the answer: when it is not empty, part of your description could not be turned into a filter and the search is broader than you meant. See Find people.
To know how big the whole audience is before you pay for any of it, send the same filters to POST /v1/people/count. Counting is free.
2

Put them in a list

A campaign writes to lists, so make one:
Then add the people the search found, as rows. Copy each person’s fields across:
A call takes up to 500 rows, and lists are free. Send it once: every row becomes a new person, so the same call sent twice adds everyone twice. See Build lists.
3

Find their work emails

Enrich the list. maxSpendUsd refuses the job before it starts if it could cost more than you allow:
It answers 202 with a job. Read the job until its status is no longer running, no faster than every 15 seconds:
A work email costs $0.02 when one is found, and nothing when none is. The job’s chargedUsd says what the run cost, and the emails are now on the list’s rows. See Enrich people.
4

Connect a mailbox

A campaign sends from a mailbox of your own. If GET /v1/accounts shows none yet, connect one: see Connect sending accounts. A mailbox costs $1 for each 30 days it stays connected.
5

Create the campaign and write its emails

A new campaign is a draft. It sends nothing until you launch it:
It starts with one empty email step. Find its id with GET /v1/campaigns/{campaignId}/steps, then write it. The subject and body go together, and the variables in braces are filled in for each person:
Add a follow-up that goes out three days after the first email:
See Run campaigns for LinkedIn steps, A/B splits and steps written by AI.
6

Check it is ready

Ask whether the campaign would start now, without starting it:
When ready is false, reason names what is missing, such as no_active_email_accounts. people shows who the campaign can reach: an email-only campaign skips the people without an email.
7

Launch

This is the only call that makes the campaign send. Emails go out between 9:00 and 17:00 in the campaign’s time zone, Monday to Friday, at five and thirty-five minutes past each hour. Sending is free.
8

Read the replies

Replies land in the inbox of the mailbox that sent the email. List the campaign’s conversations, newest first:
Each conversation carries its last message, so one call shows who answered and what they said. The inbox is free, to read and to answer from. See Work the inbox.

What the run cost

GET /v1/usage shows the same spend by day and by product. See Track your spend and Pricing and billing.