Skip to main content
POST
Add Prospects Batch (Round Robin)

Overview

Distribute a batch of prospects across multiple campaigns. Kakiyo assigns prospects to campaigns with the lowest current workload and starts an asynchronous import for each campaign that receives prospects. Each prospect can include customData, a string up to 3000 characters. It is saved on the created chat and available in prompts as {{customData}}.

Request body

Prospect object

Example

Response

Use each returned listId with Prospect Import Status. A prospect should be considered confirmed only when its report row has chatCreated: true.

Notes

  • All campaigns must belong to your team.
  • Campaigns cannot be in draft, disabled, or already uploading.
  • Round-robin processing is asynchronous per campaign.

Authorizations

Authorization
string
header
required

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

Body

application/json

Prospects to distribute across campaigns

campaignIds
string[]
required
Minimum array length: 2
Example:
prospects
object[]
required
Minimum array length: 1

Response

Prospects distributed successfully

message
string
Example:

"Round Robin distribution processing started"

totalProspects
integer
Example:

3

campaignsCount
integer
Example:

3

distribution
object[]
Last modified on June 20, 2026