Skip to main content
POST
Add LinkedIn profile URLs to an existing prospect list

Authorizations

X-API-Key
string
header
required

API Key for authentication

Path Parameters

id
string
required

Body

application/json

URL admission precedes asynchronous profile verification. Check submittedUrls, validationRejectedUrls, existedUrlsMap and outOfLimitUrls. With at least one accepted URL, partial success is returned; if none are accepted, including a wholly out-of-capacity batch, the default flow fails rather than returning empty success.

listId
string<uuid>
required

Prospect list id to add URLs to.

userUrls
string[]
required

LinkedIn profile URLs to add.

Required array length: 1 - 1000 elements
Minimum string length: 1
moveOwnDuplicated
boolean
required

For an active duplicate owned by the destination campaign owner, true moves the existing prospect record into this list and false skips it into existedUrlsMap. Same-list duplicates are skipped silently; deleted same-owner records are reactivated. Teammate duplicates are searched and skipped only when the destination campaign has skipTeammatesLeads enabled; this is not global team-wide deduplication.

shouldBeDeletedIfInactive
boolean
required

If true, auto-remove prospects who have no posts on LinkedIn within the last 30 days (checked once, when the backend first pulls their posts). If false, keep them regardless of recent posting activity.

Response

status
string
required

Response status

Allowed value: "success"
data
object
required

Detailed result of the add-users-to-list operation

message
string
required

Success message

Example:

"Operation completed successfully"