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.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. It answers A work email costs $0.02 when one is found, and nothing when none is. The job’s
maxSpendUsd refuses the job before it starts if it could cost more than you allow:202 with a job. Read the job until its status is no longer running, no faster than every 15 seconds: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 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.
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: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
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.