Phone system & SMS

Add to call list

Adds the number to the call centre's call list (campaign) — Solveline (Mantis) or another call centre with an add-record address. Without phone the contact's, then the company's phone is used; the other one goes as the second number. Empty campaign = the connection's default (a number for Solveline). With at it's an appointment: the call centre dials then and connects the agent's (user_id, default you) extension — for Solveline the extension must be mapped. A number on the do-not-call list → 409 call_list; if the number was added to the same campaign within the repeat window → 409 confirm + need_confirm: true — resend with force: 1 if the user agrees. Returns message and push (id, status sent · failed, number, provider, campaign, appointment_at, agent, extension, note, source, customer, contact). Shown on the company's activity feed.

POST/api/v1/tel/call-list

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Module: CustomersScope: crm.write

Body application/json

contact_idintegeroptional

Contact (number taken from it).

customer_idintegeroptional

Company (its phone if no contact).

phonestringoptional

Number (instead of the record's).

campaignstringoptional

Campaign / project id.

atstringoptional

Appointment time (local, YYYY-MM-DDTHH:MM).

user_idintegeroptional

Agent for the appointment.

notestringoptional

Note for the agent (max 300).

link_idintegeroptional

Connection, if several call centres are connected.

forceintegeroptional

Skip the repeat warning.

Values1

Errors

HTTP	error	Meaning
`400`	`call_list`	call_list
`409`	`call_list`	call_list
`409`	`confirm`	v67: confirmation needed (`need_confirm: true`) — campaign wording in an informational text or a number on the opt-out list; resend with `confirm: 1`.
`403`	`plan`	plan
`403`	`module`	The module is off in the licence or for the user.

Request

curl -X POST https://ornek.solk.app/api/v1/tel/call-list \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/tel/call-list", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/tel/call-list",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response