Skip to main content
POST
/
api
/
v1
/
listings
Create a new listing with rule and bulk contacts
curl --request POST \
  --url https://{subdomain}.mindhunters.ai/api/v1/listings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Call List",
  "contacts": [
    {
      "name": "John",
      "surname": "Doe",
      "phone_number": "+1234567890",
      "email": "john@example.com"
    }
  ],
  "description": "<string>",
  "campaign_type": "call",
  "start_date": "2026-02-22",
  "end_date": "2026-03-22",
  "agent_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "contact_template_setting_id": 123,
  "rule": {
    "uuid": "<string>",
    "name": "Default Rule",
    "max_calls_per_day": 3,
    "max_total_calls": 10,
    "retry_interval_minutes": 120,
    "start_time": "09:00",
    "end_time": "18:00",
    "type": "call"
  },
  "auto_start": true
}
'

Authorizations

​
Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json
​
name
string
required
Example:

"My Call List"

​
contacts
object[]
required
​
description
string | null
​
campaign_type
enum<string>
Available options:
call,
text
Example:

"call"

​
start_date
string<date>
Example:

"2026-02-22"

​
end_date
string<date>
Example:

"2026-03-22"

​
agent_uuid
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
contact_template_setting_id
integer | null
​
rule
object
​
auto_start
boolean

Auto-create tasks and start campaign

Example:

true

Response

Created