Skip to main content
POST
/
campaigns
/
{campaignId}
/
prospects
Add prospects to a campaign
curl --request POST \
  --url https://api.altahq.com/v1/campaigns/{campaignId}/prospects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "company": "<string>",
      "jobTitle": "<string>",
      "email": "<string>",
      "linkedinUrl": "<string>"
    }
  ]
}
'
{
  "error": "ValidationError",
  "message": "Invalid request body"
}
Rate limited to 10 requests per minute. Each request can include up to 20 prospects. Every prospect must have at least one contact method (email, linkedinUrl, phone) or full identity (firstName, lastName, company).

Authorizations

​
Authorization
string
header
required

API token authentication. Generate a token from the Alta dashboard and pass it as a Bearer token in the Authorization header.

Path Parameters

​
campaignId
string<uuid>
required

The UUID of the campaign to add prospects to.

Body

application/json
​
data
object[]
required

Array of prospect records to add. Each must have at least one contact method (email, linkedinUrl, phone) or full identity (firstName, lastName, company).

Required array length: 1 - 20 elements

Response

Prospects added successfully