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": "+905551234567",
      "email": "john@example.com",
      "timezone": "Europe/Istanbul",
      "country_code": "TR",
      "primary_language": "tr",
      "preferred_contact_time": "morning",
      "preferred_contact_channel": "whatsapp",
      "company": "Acme Corp",
      "city": "Istanbul",
      "lead_source": "website",
      "notes": "VIP customer"
    }
  ],
  "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

Contacts to add. Matched by phone_number (priority 1) then email (priority 2). If found, existing contact is updated with new data; otherwise a new contact is created.

​
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