Send your first call

POST /calls with a phone number (E.164) and a freeform task describing what the agent should do:

curl -X POST https://api.adamcalling.com/v1/calls \
  -H "Authorization: $ADAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+48512345678",
    "task": "You are calling on behalf of AutoParts sp. z o.o. to confirm the customer still wants the brake pads they asked about, and if so, arrange a pickup time this week.",
    "language": "pl",
    "name": "Jan",
    "metadata": {"crm_id": "42"}
  }'

{"status": "success", "call_id": "8f4e…"}

201 means the call was accepted and is being placed. Keep the call_id — it is the handle for everything that follows. language is pl (default) or hr; metadata is any JSON object you want echoed back on reads (e.g. your CRM's record id).

If the number has opted out of calls you get a 403 and no call is made.

Instead of a freeform task, you can send a pathway_id referencing a stored, versioned conversation flow — exactly one of the two, never both. See Use a pathway.