Quick Start
Get started with IceCore API in 5 minutes.
Published Nov 27, 2025Nov 27, 2025
2 min read
Knowledge BaseKB1. 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:
Was this helpful?