How do I make my first API call?
Replace $FLAXXA_KEY with a key from your workspace. The first call returns a real id you can use for the next ones.
cURL
# 1. Incoming webhook — the URL from Pulse → Webhooks & Bots. Any JSON body is posted as a message.
curl -X POST https://flaxxa.com/hooks/pulse/WEBHOOK_TOKEN \
-H "Content-Type: application/json" \
-d '{ "alert": "Checkout latency > 2s", "service": "payments", "severity": "high" }'
# 2. API key — post as yourself into #alerts.
curl -X POST https://flaxxa.com/api/v1/pulse/channels/by-slug/alerts/messages \
-H "Authorization: Bearer flx_live_YOUR_KEY" \
-H "Accept: application/json" -H "Content-Type: application/json" \
-d '{ "body": "Deploy v2.14 finished — 0 errors in the first 10 minutes." }'PHP
// Alert a channel from a Laravel app (API key, posts as the key's owner).
Http::withToken(env('FLAXXA_PULSE_KEY'))->acceptJson()
->post('https://flaxxa.com/api/v1/pulse/channels/by-slug/alerts/messages', [
'body' => "Order #{$order->id} failed payment: {$order->failure_reason}",
])->throw();
// Or the incoming webhook — no key, the whole payload becomes the message.
Http::post('https://flaxxa.com/hooks/pulse/' . env('FLAXXA_PULSE_HOOK'), [
'order' => $order->id, 'status' => 'payment_failed', 'reason' => $order->failure_reason,
]);Node
await fetch("https://flaxxa.com/api/v1/pulse/channels/by-slug/alerts/messages", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.FLAXXA_PULSE_KEY}`, Accept: "application/json", "Content-Type": "application/json" },
body: JSON.stringify({ body: "Nightly backup completed — 42 GB in 11 min." }),
});Python
import requests
requests.post("https://flaxxa.com/api/v1/pulse/channels/by-slug/alerts/messages",
headers={"Authorization": f"Bearer {KEY}", "Accept": "application/json"},
json={"body": "Model retrain finished: AUC 0.91 (+0.02)."}).raise_for_status()Request
POST /api/v1/pulse/channels/by-slug/alerts/messages HTTP/1.1
Host: flaxxa.com
Authorization: Bearer flx_live_·············
Content-Type: application/json
{ "body": "Deploy v2.14 finished — 0 errors in the first 10 minutes." }Response · 201
HTTP/1.1 201 Created
Content-Type: application/json
{
"data": {
"id": 90213, "channel_id": 418, "user_id": 77, "parent_message_id": null,
"body": "Deploy v2.14 finished — 0 errors in the first 10 minutes.",
"kind": "user", "has_attachments": false, "reply_count": 0,
"user": { "id": 77, "name": "Deploy bot (Rahul)" }, "attachments": [], "reactions": [],
"created_at": "2026-10-27T10:00:00+00:00"
}
}