Skip to main content
POST
/
api
/
campaign
Create Campaign
curl --request POST \
  --url https://api.getello.ai/api/campaign \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'campaignName=Follow-up Campaign October' \
  --form assistantId=685d4b93abcf4c90c18034aa \
  --form file='@example-file' \
  --form scheduleTime=2025-10-29T11:30:00.000Z \
  --form scheduleEnabled=true
{
  "status": 200,
  "message": "Campaign created successfully",
  "data": {
    "campaign_id": "6901c1d8b004a5d55a123abc",
    "campaignName": "Follow-up Campaign October",
    "status": "scheduled"
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

multipart/form-data
​
campaignName
string
required

The name of the campaign.

Example:

"Follow-up Campaign October"

​
assistantId
string
required

The ID of the assistant (agent) associated with this campaign.

Example:

"685d4b93abcf4c90c18034aa"

​
file
file
required

CSV file containing the list of recipients for the campaign.

​
scheduleTime
string<date-time>

Scheduled time for the campaign in ISO format.

Example:

"2025-10-29T11:30:00.000Z"

​
scheduleEnabled
string

Set to 'true' to enable scheduling for the campaign.

Example:

"true"

Response

Campaign created successfully

​
status
integer
Example:

200

​
message
string
Example:

"Campaign created successfully"

​
data
object
Example:
{
  "campaign_id": "6901c1d8b004a5d55a123abc",
  "campaignName": "Follow-up Campaign October",
  "status": "scheduled"
}