Kronos API

Authorization: Bearer kronos_sk_live_<random>

{
  account: {
    user_id: string,
    display_name: string | null,
    company_name: string | null,
    onboarding_state: "onboarding" | "dashboard",
    onboarding_completed_at: string | null
  },
  counts: {
    agents_total: number,
    agents_active: number,
    integrations_total: number,
    connected_channels: string[],
    conversations_total: number,
    messages_7d: number,
    contacts_total: number,
    open_followups: number,
    pending_kron_cards: number,
    voice_calls_inbound_30d: number,
    voice_calls_outbound_30d: number
  },
  onboarding: { exists: boolean, is_first_onboarding: boolean, use_cases: string[] },
  agents: Array<{ id: string, name: string, is_active: boolean, model_id: string | null }>,
  integrations: Array<{ id: string, platform: string, account_name: string | null }>
}

curl https://api.kronos.com.mx/v1/account/overview \
  -H "Authorization: Bearer $KRONOS_API_KEY"

// start_integration_connection
{ provider: "instagram" | "facebook" | "messenger" | "whatsapp" | "gmail" | "shopify" | "telegram" | "mcp", return_to?: string }

// create_draft_agent
{ name: string, description?: string, prompt?: string }

// update_agent_configuration
{ agent_id: string, name?: string, description?: string, prompt?: string, is_active?: boolean, memory_level?: "disabled" | "simple" | "advanced" | "pro", followup_mode?: "disabled" | "classic" | "agentic" | "guided", temperature?: number }

// reassign_agent
{ target_type: "inbox", inbox_id: string, agent_id: string }
// or
{ target_type: "conversations", conversation_ids: string[], agent_id: string }

{
  "action_name": "create_draft_agent",
  "data": { "...": "action-specific payload" }
}

{
  external_user_id: string,
  external_conversation_id?: string,
  message_id: string,                // required idempotency key
  content: string,                   // 1..4096 chars
  sender?: { name?: string, email?: string, phone?: string },
  metadata?: Record<string, unknown>,// max 10KB and 50 top-level keys
  new_conversation?: boolean
}

{
  "status": "accepted",
  "integration_id": "4ad91e83-7d48-4371-9f2f-4505c7912c2e",
  "conversation_id": "b8e547b4-3837-49d2-9f4b-6c2e9d01fd7d",
  "external_conversation_id": "thread_abc123",
  "inbound_message_id": "99618f3e-4f7a-4e17-896e-250f6a92db31",
  "idempotent_replay": false,
  "created_at": "2026-07-06T09:12:27.852Z"
}

curl -X POST https://api.kronos.com.mx/v1/custom-inboxes/4ad91e83-7d48-4371-9f2f-4505c7912c2e/messages \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_user_id": "user_123",
    "external_conversation_id": "thread_abc123",
    "message_id": "msg_0001",
    "content": "Hola, quiero revisar mi pedido",
    "sender": { "name": "María" },
    "metadata": { "source": "mobile_app" }
  }'

{
  channel:        "whatsapp" | "instagram" | "messenger" | "telegram",
  integration_id?: string,        // optional when you have ONE inbox on this channel;
                                  // REQUIRED when you have multiple (else 412)
  recipient:      string,         // wa_id | IG PSID | Messenger PSID
  message: {
    type: "text";
    text: string                  // max 4096 chars
  } | {
    type: "template";             // WhatsApp only
    template: {
      name:     string,
      language: string,           // e.g. "en_US"
      components?: Array<{ type, parameters?: object[] }>
    }
  } | {
    type: "media";
    media: {
      url:       string,           // public URL
      mediaType: "image" | "video" | "audio" | "document",
      caption?:  string            // max 1024 chars
    }
  },
  tag?:             "CONFIRMED_EVENT_UPDATE" | "POST_PURCHASE_UPDATE"
                  | "ACCOUNT_UPDATE" | "HUMAN_AGENT",   // IG / Messenger >24h
  idempotency_key?: string         // 8..128 chars
}

{
  "id":         "wamid.HBgN...",   // Meta's platform_message_id
  "channel":    "whatsapp",
  "status":     "sent",
  "created_at": "2026-05-11T07:42:27.852Z"
}

curl -X POST https://api.kronos.com.mx/v1/messages/send \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel":   "whatsapp",
    "recipient": "5215555555555",
    "message":   { "type": "text", "text": "Hi! Your order is ready." }
  }'

curl -X POST https://api.kronos.com.mx/v1/messages/send \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel":   "whatsapp",
    "recipient": "5215555555555",
    "message": {
      "type": "template",
      "template": {
        "name":     "appointment_reminder",
        "language": "en_US",
        "components": [{
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Maria" },
            { "type": "text", "text": "Tuesday at 10:00 AM" }
          ]
        }]
      }
    }
  }'

curl -X POST https://api.kronos.com.mx/v1/messages/send \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel":   "instagram",
    "recipient": "psid_1234567890",
    "tag":       "POST_PURCHASE_UPDATE",
    "message":   { "type": "text", "text": "Tracking #ABC123 has shipped." }
  }'

curl -X POST https://api.kronos.com.mx/v1/messages/send \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel":   "messenger",
    "recipient": "psid_1234567890",
    "message": {
      "type": "media",
      "media": {
        "url":       "https://cdn.example.com/receipt.png",
        "mediaType": "image",
        "caption":   "Here is your receipt."
      }
    }
  }'

const res = await fetch("https://api.kronos.com.mx/v1/messages/send", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KRONOS_API_KEY}`,
    "Content-Type":  "application/json",
  },
  body: JSON.stringify({
    channel:   "whatsapp",
    recipient: "5215555555555",
    message:   { type: "text", text: "Hi from TS!" },
    idempotency_key: `order-confirmation-${orderId}`,
  }),
});

if (!res.ok) {
  const err = await res.json();
  throw new Error(`Kronos API ${res.status}: ${err.error?.code}`);
}
const { id, channel, status, created_at } = await res.json();

X-Idempotent-Replay: true

{
  "id":           "wamid.HBgN...",
  "channel":      "whatsapp",
  "content":      "Hi! Your order is ready.",
  "message_type": "text",
  "created_at":   "2026-05-11T07:42:27.852Z"
}

curl https://api.kronos.com.mx/v1/messages/wamid.HBgN1234567890ABCDEF \
  -H "Authorization: Bearer $KRONOS_API_KEY"

{
  to:             string,           // phone number to call, international format
                                    // (with or without leading "+"; both work).
                                    // 8-15 digits, first non-zero.
  agent_id:       string,           // UUID of the AI agent that should voice
                                    // the call. The agent MUST have the Voice
                                    // channel enabled.
  context?:       string,           // optional briefing for the agent ("background"
                                    // not "instructions"). Max 2000 chars.
  integration_id?: string,          // optional voice number id. Required only if
                                    // you have more than one voice number connected.
  tag?:           string,           // optional free-form correlation id (lead id,
                                    // ticket number, etc.). Max 100 chars.
  idempotency_key?: string          // 8..128 chars. Reuse to safely retry; same
                                    // key + same body returns the original
                                    // response with X-Idempotent-Replay: true.
}

{
  "call_id":         "7d63af24-68dc-4928-b8f7-cab7c317964a",
  "twilio_call_sid": "CA159e953f1b7aa13831b4c4445cb412fa",
  "from":            "+15187329372",
  "to":              "+5215512345678",
  "status":          "initiated",
  "agent_id":        "547ce9ba-55b5-4992-baaa-bdfb232310aa"
}

curl -X POST https://api.kronos.com.mx/v1/calls/initiate \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to":              "+5215555555555",
    "agent_id":        "547ce9ba-55b5-4992-baaa-bdfb232310aa",
    "context":         "Customer asked about onboarding. They are in CDMX. Speak Spanish.",
    "idempotency_key": "lead-followup-2026-05-22-001"
  }'

{
  "numbers": [
    {
      "integration_id":   "c7fa52fa-83f1-446e-bbc3-a8a628ec24e7",
      "phone_number":     "+15187329372",
      "inbox_name":       "Support",
      "iso_country":      "US",
      "default_agent_id": "547ce9ba-55b5-4992-baaa-bdfb232310aa"
    }
  ]
}

curl https://api.kronos.com.mx/v1/voice/numbers \
  -H "Authorization: Bearer $KRONOS_API_KEY"