GiGi Developer Portal

Build with the GiGi public API. v0 — partner-traffic gated until your account is flipped to live mode.

← Back to GiGi

Webhook Events

Every event we currently fire. Subscribe to one or more on the Webhooks page.

agent.coaching_insight_created

GiGi has a new coaching insight ready for the agent to review.

Fires when: A coaching loop run completes and produces at least one new insight.

Sample payload
{
  "id": "evt_demo_01",
  "type": "agent.coaching_insight_created",
  "account_id": "<your account uuid>",
  "created_at": "2026-05-03T12:00:00Z",
  "data": {
    "insight_id": "ins_demo_01",
    "headline": "You closed 3 buyer consults this week — strong momentum.",
    "created_at": "2026-05-03T12:00:00Z"
  }
}

sentinel.fired

A platform sentinel fired for the agent's account (e.g. data drift, missed follow-up).

Fires when: Any sentinel records a firing on this account.

Sample payload
{
  "id": "evt_demo_01",
  "type": "sentinel.fired",
  "account_id": "<your account uuid>",
  "created_at": "2026-05-03T12:00:00Z",
  "data": {
    "firing_id": "fir_demo_01",
    "sentinel_name": "missed_followup_72h",
    "triggered_at": "2026-05-03T12:00:00Z",
    "action_taken": "notify_agent"
  }
}

deal.stage_changed

A deal moved between pipeline stages.

Fires when: Any deal's stage column transitions to a new value.

Sample payload
{
  "id": "evt_demo_01",
  "type": "deal.stage_changed",
  "account_id": "<your account uuid>",
  "created_at": "2026-05-03T12:00:00Z",
  "data": {
    "deal_id": "deal_demo_01",
    "from_stage": "consultation",
    "to_stage": "active_buyer",
    "changed_at": "2026-05-03T12:00:00Z"
  }
}

client.contacted

GiGi recorded a contact event with a client (call, email, or SMS).

Fires when: A contact log entry is written via the dialer, email adapter, or SMS adapter.

Sample payload
{
  "id": "evt_demo_01",
  "type": "client.contacted",
  "account_id": "<your account uuid>",
  "created_at": "2026-05-03T12:00:00Z",
  "data": {
    "contact_id": "ct_demo_01",
    "client_id": "cl_demo_01",
    "channel": "phone",
    "occurred_at": "2026-05-03T12:00:00Z"
  }
}

goal.pace_changed

The agent's goal pace crossed an alert threshold.

Fires when: The goal pacing aggregator detects the agent has moved between on-pace, behind, or ahead.

Sample payload
{
  "id": "evt_demo_01",
  "type": "goal.pace_changed",
  "account_id": "<your account uuid>",
  "created_at": "2026-05-03T12:00:00Z",
  "data": {
    "goal_id": "g_demo_01",
    "pace": "behind",
    "previous_pace": "on_pace",
    "changed_at": "2026-05-03T12:00:00Z"
  }
}