Quick Start

1. Get Your API Key

Navigate to Settings → API Keys in your IceCore workspace.

Click "Create API Key" and save it securely - you'll only see it once!

{
  "key": "sk_live_abc123...",
  "warning": "Save this key securely!"
}

2. Make Your First Request

curl https://icecore.ai/api/v1/conversations \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json"

Response:

{
  "data": [
    {
      "_id": "conv_123",
      "status": "open",
      "channel": "whatsapp",
      "classification": {
        "category": "Support",
        "priority": "medium"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "total": 50
  }
}

3. Send a Message

curl -X POST https://icecore.ai/api/v1/messages/send \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "conversationId": "conv_123",
    "text": "Hello from API!"
  }'

4. Setup Webhooks (Optional)

Receive real-time events when things happen in your workspace.

curl -X POST https://icecore.ai/api/webhooks \
  -H "Cookie: your_session_cookie" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "your-workspace-id",
    "url": "https://your-server.com/webhooks",
    "events": ["conversation.resolved", "csat.low"]
  }'

Note: Webhook management requires session cookie authentication (from IceCore dashboard), not API key authentication.

Rate Limits

• Default: 60 requests/minute per API key

• Enterprise: Custom limits available

Authentication

All API requests require an API key in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

Support

• Documentation: https://icecore.ai/docs/api

• Email: support@icecore.ai

• Status: https://status.icecore.ai

Next Steps:

• Authentication Guide

• WhatsApp Bulk Sending

• Webhooks Guide