POST
/
api
/
v2
/
linkedin
/
upload-prospects
curl -X POST \
  https://api.buena.ai/api/v2/linkedin/upload-prospects \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prospects": [
      {
        "name": "John Doe",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "email": "john@example.com",
        "company": "Example Corp",
        "title": "CEO"
      }
    ],
    "campaign_id": "camp_123",
    "tags": ["enterprise", "q1-2024"]
  }'

{
  "uploaded_count": 1,
  "skipped_count": 0,
  "errors": [],
  "prospect_ids": ["prospect_456"]
}

Upload a list of prospects to be used in LinkedIn automation campaigns.

​
Request Body

​
prospects
array
required

Array of prospect objects to upload

​
prospects[].name
string
required

Full name of the prospect

​
prospects[].linkedin_url
string
required

LinkedIn profile URL of the prospect

​
prospects[].email
string

Email address of the prospect

​
prospects[].company
string

Company name where the prospect works

​
prospects[].title
string

Job title of the prospect

​
prospects[].notes
string

Additional notes about the prospect

​
campaign_id
string

ID of the campaign to associate these prospects with

​
tags
array

Array of tags to apply to all uploaded prospects

​
Response

​
uploaded_count
number

Number of prospects successfully uploaded

​
skipped_count
number

Number of prospects that were skipped (duplicates, invalid data, etc.)

​
errors
array

Array of error messages for prospects that couldn’t be uploaded

​
prospect_ids
array

Array of IDs for the successfully uploaded prospects

curl -X POST \
  https://api.buena.ai/api/v2/linkedin/upload-prospects \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prospects": [
      {
        "name": "John Doe",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "email": "john@example.com",
        "company": "Example Corp",
        "title": "CEO"
      }
    ],
    "campaign_id": "camp_123",
    "tags": ["enterprise", "q1-2024"]
  }'

{
  "uploaded_count": 1,
  "skipped_count": 0,
  "errors": [],
  "prospect_ids": ["prospect_456"]
}