Introduction

​

Getting Started

​

Event Categories

​

Partner Events

• partner_created - New partnership established
• partner_updated - Partnership information changed
• partner_contact_created - New contact added to partnership
• partner_contact_updated - Partner contact information changed

​

Lead Events

• lead_created - New lead received
• lead_updated - Lead information changed
• lead_deleted - Lead archived
• lead_note_created - Note added to lead
• lead_note_updated - Lead note modified
• lead_note_deleted - Note removed from lead

​

Deal Events

• deal_created - New deal created
• deal_updated - Deal information or stage changed
• deal_deleted - Deal archived
• deal_note_created - Note added to deal
• deal_note_updated - Deal note modified
• deal_note_deleted - Note removed from deal

​

Message Events

• message_created - New message in partnership room
• message_updated - Message content updated
• message_deleted - Message removed

​

Integration Flow

1. Create Integration: Set up your integration in JourneyBee dashboard
2. Configure Webhook URL: Provide your endpoint URL for receiving webhooks
3. Get Integration UUID: Use this as your JWT secret for verification
4. Subscribe to Events: Choose which events your integration should receive
5. Handle Webhooks: Process incoming webhook requests with JWT verification

​

Quick Example

const express = require("express");
const jwt = require("jsonwebtoken");

app.post("/webhook", (req, res) => {
  const token = req.headers.authorization?.split("Bearer ")[1];

  try {
    const decoded = jwt.verify(token, process.env.INTEGRATION_UUID);
    console.log("Event:", decoded.event_id);
    console.log("Company:", decoded.company_uuid);

    // Process webhook payload
    const { lead, deal, partnership } = req.body;

    res.status(200).send("OK");
  } catch (error) {
    res.status(401).send("Invalid token");
  }
});

​

Next Steps