Developer documentation

Connect LeadCeleris to your stack with REST API keys and signed webhooks.

Getting started

1. Create a free account at app.leadceleris.com.
2. Open Developers in the app to create an API key and register webhook URLs.
3. Send requests to https://api.leadceleris.com with your key in the Authorization header.

API authentication

Include your secret key on every request. Keys start with lc_live_ (production) or lc_test_ (sandbox).

Authorization: Bearer lc_live_xxxxxxxxxxxxxxxx

Keep keys server-side only. Rotate them from the Developers page if exposed.

Webhooks

LeadCeleris sends event payloads to URLs you configure. Each request includes an HMAC-SHA256 signature in the X-LeadCeleris-Signature header so you can verify the payload was sent by us.

Compute the expected signature with your webhook secret and the raw request body, then compare it to the header value using a constant-time comparison.

const crypto = require("crypto");

const signature = req.headers["x-leadceleris-signature"];
const expected = crypto
  .createHmac("sha256", webhookSecret)
  .update(rawBody)
  .digest("hex");

if (signature !== expected) {
  return res.status(401).send("Invalid signature");
}

Events

Common webhook event types:

• message.received — a customer sent a WhatsApp message
• message.sent — your AI or team sent an outbound message
• contact.created — a new contact was added to your org
• escalation.created — AI flagged a conversation for human follow-up

Each payload includes type, id, createdAt, and a data object with event details.

Example requests

List recent conversations:

curl -s "https://api.leadceleris.com/api/conversations?limit=10" \
  -H "Authorization: Bearer lc_live_xxxxxxxxxxxxxxxx"

Send a message to a contact:

curl -s -X POST "https://api.leadceleris.com/api/messages" \
  -H "Authorization: Bearer lc_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "cnt_abc123",
    "body": "Thanks for reaching out — how can we help?"
  }'

Health check (no auth required):

curl -s "https://api.leadceleris.com/health"

App dashboard

Manage API keys, webhook endpoints, and view delivery logs in the app:

Open Developers page →

Need help? Email support@leadceleris.com or see our integrations guide.