Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the JustCall connector page.How JustCall webhooks are set up
StackOne creates and manages the webhook subscription automatically when the account is connected, and removes it when the account is disconnected. There is nothing to configure in JustCall and no URL to paste.
- JustCall accepts one event type per webhook subscription, so StackOne registers one subscription for each event you enable.
- Subscriptions are account-wide and cover every user and phone number on the JustCall account.
- Each subscription appears in JustCall under APIs and Webhooks with the StackOne callback URL.
Available webhook events
The following JustCall events can be enabled. Only events selected in StackOne are subscribed and delivered. JustCall does not send events that have no subscription.
Call events
Events on calls made or received through JustCall.
- Call Incoming (
call.incoming) — Fired when an incoming call starts ringing. - Call Initiated (
call.initiated) — Fired when an outgoing call is initiated. - Call Answered (
call.answered) — Fired when a call is answered. - Call Enters Queue (
call.enters_queue) — Fired when a call enters a call queue. - Call Exits Queue (
call.exits_queue) — Fired when a call leaves a call queue. - Call Completed (
call.completed) — Fired when a call ends. - Call Missed (
call.missed) — Fired when a call is missed. - Call Voicemail (
call.voicemail) — Fired when a caller leaves a voicemail. - Call Updated (
call.updated) — Fired when fields on an existing call are updated. The payload contains only the call ID and the changed fields. - Call AI Generated (
jc.call_ai_generated) — Fired when JustCall AI finishes generating insights for a call.
AI voice agent events
Events on calls handled by a JustCall AI voice agent.
- Call AI Voice Agent (
call.ai_voice_agent) — Fired when an AI voice agent executes actions on a call.
SMS events
Events on text messages.
- SMS Sent or Received (
sms.sent_received) — Fired when an SMS is sent or received. - SMS Sent (
sms.sent) — Fired when an SMS is sent. - SMS Received (
sms.received) — Fired when an SMS is received. - SMS Status Updated (
sms.status_updated) — Fired when the delivery status of an SMS changes.
WhatsApp events
Events on WhatsApp messages.
- WhatsApp Message Sent (
whatsapp.message_sent) — Fired when a WhatsApp message is sent. - WhatsApp Message Received (
whatsapp.message_received) — Fired when a WhatsApp message is received. - WhatsApp Message Status Updated (
whatsapp.message_status_updated) — Fired when the delivery status of a WhatsApp message changes.
Sales Dialer events
Events on Sales Dialer campaign calls (Pro plan or above).
- Sales Dialer Call Completed (
sd.call_completed) — Fired when a Sales Dialer campaign call ends. - Sales Dialer Call Updated (
sd.call_updated) — Fired when fields on a Sales Dialer call are updated. The payload contains only the changed fields. - Sales Dialer Call AI Generated (
sd.call_ai_generated) — Fired when JustCall AI finishes generating insights for a Sales Dialer call.
Contact and appointment events
Events on contacts and scheduled appointments.
- Contact Status Updated (
jc.contact_status_updated) — Fired when a contact is added to or removed from the DND, DNM or Blacklist lists. - Appointment Scheduled (
appointment.scheduled) — Fired when an appointment is booked on a JustCall calendar.
Delivery format
Details of how JustCall delivers events to StackOne.
One event per request
JustCall sends each event as its own HTTP POST with a JSON body containing request_id, type and the event data. Deliveries are not batched, may arrive more than once and are not guaranteed to be in order.
Retries and blacklisting
JustCall retries failed deliveries up to 5 times, 30 to 90 seconds apart. URLs that fail repeatedly are blacklisted and stop receiving events.
Signature
JustCall signs each delivery with an x-justcall-signature header, an HMAC-SHA256 of the webhook URL, event type and x-justcall-request-timestamp keyed with the account’s API Secret.