Webhooks

JustAI uses inbound webhooks to receive engagement and delivery events from your messaging platform. This data powers the bandit optimization engine — the more events JustAI receives, the faster it learns which variants perform best.

How It Works

You configure your messaging platform to forward events (sends, opens, clicks, conversions) to a JustAI webhook URL.
JustAI matches each event to the variant that was served, using the tracking_id or platform-specific identifiers.
The optimization engine updates its model, improving future variant selection.

Webhook URLs

Each integration has its own webhook endpoint:

Platform	Endpoint
Customer.io	`POST https://worker.justwords.ai/api/webhook/cio/:org_slug`
Iterable	`POST https://worker.justwords.ai/api/webhook/itbl/:org_slug`
Braze	`POST https://worker.justwords.ai/api/webhook/braze/:org_slug`
Segment	`POST https://worker.justwords.ai/api/webhook/segment/:org_slug`
Salesforce Marketing Cloud	`POST https://worker.justwords.ai/api/webhook/sfmc/:org_slug`
Custom Events	`POST https://worker.justwords.ai/api/webhook/events/:org_slug`

Replace :org_slug with your organization identifier (e.g., your-company-name).

Event Types

JustAI processes the following event types from each platform:

Delivery events — confirms the message was sent.
Engagement events — opens, clicks, and other interactions.
Conversion events — downstream actions tied to a message.

The exact event names and payload formats vary by platform. JustAI normalizes them internally.

Setup

Webhook configuration is done in your messaging platform’s settings. For step-by-step setup instructions, see the integration guide for your platform:

Custom Events

The custom events endpoint (/api/webhook/events/:org_slug) accepts arbitrary event data that doesn’t come from a supported platform. Use this to send conversion or engagement signals from your own backend.