Skip to main content
POST
Buy email addresses for a prospect's people
Pass the prospect id and peopleIds from Outreach Contacts. To look up people across multiple prospects in one request, use Find Emails in Bulk. The 202 response reports queued, queuedPeopleIds, skipped, and creditsCharged. queuedPeopleIds are person IDs, not worker job IDs. Poll Outreach Contacts while a queued person’s status is enriching; the result is reflected in their email and terminal status. The request charges 10 AI credits per eligible person queued. People already looked up or mid-lookup are skipped without a charge. Lookups that cannot be started or finish without an address are refunded, so creditsCharged is the upfront total, not necessarily the final cost.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Prospect ID.

Body

application/json
peopleIds
string[]
required

People IDs from outreach_prospect_people, all on this prospect.

Required array length: 1 - 2000 elements

Response

202 - application/json

Default Response

ok
boolean
queued
integer
queuedPeopleIds
string[]

People whose email lookups were accepted. Read their terminal statuses from the people list; these are not worker job IDs.

skipped
integer
creditsCharged
number