Callbacks (webhooks)

Register a URL to receive HTTP POST notifications when community events occur. All management calls require a business JWT.

Register a callback

const { data } = await api.addCallback({
  body: { url: 'https://your-server.com/cc-webhook' },
});

List callbacks

const { data } = await api.listCallbacks();

Remove a callback

await api.removeCallback({ path: { id: callbackId } });

Payload format

The platform posts a JSON payload to your URL on each event. The exact payload shape depends on the event type. Your endpoint should return a 2xx response quickly — processing should be async.

Timeouts

If your endpoint does not respond promptly, the request may time out. Keep webhook handlers lightweight and offload heavy work to a queue.