Skip to main content
POST
/
prospects
Add prospect to list
curl --request POST \
  --url https://api.goextrovert.com/client/v1/prospects \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "prospectProfileUrl": "https://www.linkedin.com/in/john-doe",
  "prospectListId": "123e4567-e89b-12d3-a456-426614174000",
  "campaignId": "123e4567-e89b-12d3-a456-426614174001",
  "moveDuplicatedProspect": false
}'
{
  "status": "success",
  "data": null,
  "message": "Operation completed successfully",
  "statusCode": 201
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Body

application/json
​
prospectProfileUrl
string
required

LinkedIn profile URL of the prospect

Example:

"https://www.linkedin.com/in/john-doe"

​
prospectListId
string<uuid>
required

UUID of the prospect list. To get this ID: 1. Open your prospect list in Extrovert web app, 2. Copy the URL from your browser, 3. Extract the second UUID from the URL. Example: https://app.goextrovert.com/dashboard/campaign/main/{campaignId}/target-user/{prospectListId} - The prospect list ID is the second UUID in the URL.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
campaignId
string<uuid>
required

UUID of the campaign. Must match the campaign ID of the prospect list. To get this ID: 1. Open your campaign in Extrovert web app, 2. Copy the URL from your browser, 3. Extract the first UUID from the URL. Example: https://app.goextrovert.com/dashboard/campaign/main/{campaignId}/target-user - The campaign ID is the first UUID in the URL.

Example:

"123e4567-e89b-12d3-a456-426614174001"

​
moveDuplicatedProspect
boolean
default:false
required

If true, moves existing prospects from other lists to this list. If false, trhows an error if duplicate is found

Response

Prospect successfully added

​
status
string
Example:

"success"

​
data
null
Example:

null

​
message
string
Example:

"Operation completed successfully"

​
statusCode
integer
Example:

201

⌘I