Webhooks
Signed HTTP callbacks for inbound messages, delivery, billing, and cycle jobs. Verify the signature before you act.
Organization
Parent
Webhook
This guide
Event types
| Event | When |
|---|---|
| cell.message.received | Inbound SMS |
| cell.message.sent | Outbound accepted |
| cell.message.delivered | Carrier delivery receipt |
| cell.message.failed | Delivery failure |
| cell.message.ignored | Inbound from ignored number (opt-in) |
| pod.cycle.completed | Cycle job finished |
| billing.payment_succeeded | Stripe payment completed |
| billing.x402.settled | x402 payment credited |
Set a webhook
Retries are exponential. Failed deliveries appear in the console webhook log (read-only).
await agentcell.webhooks.create({ url: "https://your-server.com/webhook", events: ["cell.message.received"] });Common errors
- VALIDATION_ERROR
URL must be HTTPS.
Copy for Cursor / Claude
POST https://api.agentcell.store/v1/webhooks
{"url":"https://your-server.com/webhook","events":["cell.message.received","cell.message.delivered"]}
Verify the signature before processing.