Webhook Payload Reference

This document provides the event-wise structure of webhook payloads sent by Outboundry.

Each event sends a POST request with a JSON body containing event metadata and contextual data about the lead, campaign, and activity.


Common Payload Structure

All webhook events follow a consistent base structure:

{
  "event": "event-name",
  "timestamp": "ISO-8601 timestamp",
  "data": {
    // Event-specific payload
  }
}

Fields

Field

Type

Description

event

string

Name of the event

timestamp

string

Time when the event occurred

data

object

Event-specific data


LinkedIn Events


invite-sent

Triggered when a connection request is sent.

{
  "event": "invite-sent",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T10:15:00.000Z",
  "data": {
    "actionData": {
      "message": "Invitation Sent Successfully",
      "invitation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "lead": {
      "id": "11111111-aaaa-bbbb-cccc-111111111111",
      "name": "Rahul Sharma",
      "profile_url": "https://linkedin.com/in/rahulsharma",
      "email": "[email protected]",
      "latest_status": "Contacted",
      "activity": [
        {
          "action": "Send connection request",
          "action_time": "2026-03-24T10:15:00.000Z"
        }
      ],
      "company_name": "Infosys",
      "location": "Bangalore",
      "job_title": "Senior Software Engineer",
      "profile_image": "https://media.licdn.com/dms/image/sample1.jpg"
    },
    "campaign": {
      "id": "cccccccc-1111-2222-3333-cccccccccccc",
      "name": "Q1 LinkedIn Outreach",
      "campaign_type": "linkedin",
      "total_leads": 150,
      "complete_end_of_sequence": 12
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

invite-accepted

Triggered when a prospect accepts your connection request.

{
  "event": "invite-accepted",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T11:30:00.000Z",
  "data": {
    "actionData": {
      "message": "Invitation Accepted"
    },
    "lead": {
      "id": "11111111-aaaa-bbbb-cccc-111111111111",
      "name": "Rahul Sharma",
      "profile_url": "https://linkedin.com/in/rahulsharma",
      "email": "[email protected]",
      "latest_status": "Engaged",
      "activity": [
        {
          "action": "Send connection request",
          "action_time": "2026-03-23T10:15:00.000Z"
        },
        {
          "action": "Invite Accepted",
          "action_time": "2026-03-24T11:30:00.000Z"
        }
      ],
      "company_name": "Infosys",
      "location": "Bangalore",
      "job_title": "Senior Software Engineer",
      "profile_image": "https://media.licdn.com/dms/image/sample1.jpg"
    },
    "campaign": {
      "id": "cccccccc-1111-2222-3333-cccccccccccc",
      "name": "Q1 LinkedIn Outreach",
      "campaign_type": "linkedin",
      "total_leads": 150,
      "complete_end_of_sequence": 12
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

message-sent

Triggered when a LinkedIn message is sent after connection.

{
  "event": "message-sent",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T12:00:00.000Z",
  "data": {
    "actionData": {
      "message": "Hi Rahul, wanted to connect regarding an exciting opportunity!",
      "latest_chat_id": "d4e5f6a7-b8c9-0123-def0-123456789abc",
      "latest_message_id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd"
    },
    "lead": {
      "id": "11111111-aaaa-bbbb-cccc-111111111111",
      "name": "Rahul Sharma",
      "profile_url": "https://linkedin.com/in/rahulsharma",
      "email": "[email protected]",
      "latest_status": "Contacted",
      "activity": [
        {
          "action": "Send connection request",
          "action_time": "2026-03-22T09:00:00.000Z"
        },
        {
          "action": "Invite Accepted",
          "action_time": "2026-03-23T10:00:00.000Z"
        },
        {
          "action": "Send Message",
          "action_time": "2026-03-24T12:00:00.000Z"
        }
      ],
      "company_name": "Infosys",
      "location": "Bangalore",
      "job_title": "Senior Software Engineer",
      "profile_image": "https://media.licdn.com/dms/image/sample1.jpg"
    },
    "campaign": {
      "id": "cccccccc-1111-2222-3333-cccccccccccc",
      "name": "Q1 LinkedIn Outreach",
      "campaign_type": "linkedin",
      "total_leads": 150,
      "complete_end_of_sequence": 12
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

message-replied

Triggered when a prospect replies to your LinkedIn message.

{
  "event": "message-replied",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T14:20:00.000Z",
  "data": {
    "actionData": {
      "replay_message": "Hey! Sure, I'd love to hear more about it."
    },
    "lead": {
      "id": "11111111-aaaa-bbbb-cccc-111111111111",
      "name": "Rahul Sharma",
      "profile_url": "https://linkedin.com/in/rahulsharma",
      "email": "[email protected]",
      "latest_status": "Replied",
      "activity": [
        {
          "action": "Send connection request",
          "action_time": "2026-03-21T09:00:00.000Z"
        },
        {
          "action": "Invite Accepted",
          "action_time": "2026-03-22T10:00:00.000Z"
        },
        {
          "action": "Send Message",
          "action_time": "2026-03-23T12:00:00.000Z"
        },
        {
          "action": "Message Replied",
          "action_time": "2026-03-24T14:20:00.000Z"
        }
      ],
      "company_name": "Infosys",
      "location": "Bangalore",
      "job_title": "Senior Software Engineer",
      "profile_image": "https://media.licdn.com/dms/image/sample1.jpg"
    },
    "campaign": {
      "id": "cccccccc-1111-2222-3333-cccccccccccc",
      "name": "Q1 LinkedIn Outreach",
      "campaign_type": "linkedin",
      "total_leads": 150,
      "complete_end_of_sequence": 12
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

inmail-sent

Triggered when an InMail is sent.

{
  "event": "inmail-sent",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T09:45:00.000Z",
  "data": {
    "actionData": {
      "subject": "Exciting Opportunity at Outboundry",
      "message": "Hi Priya, I came across your profile and think you'd be a great fit...",
      "latest_chat_id": "f6a7b8c9-d0e1-2345-f012-3456789abcde",
      "latest_message_id": "a7b8c9d0-e1f2-3456-0123-456789abcdef"
    },
    "lead": {
      "id": "22222222-bbbb-cccc-dddd-222222222222",
      "name": "Priya Nair",
      "profile_url": "https://linkedin.com/in/priyanair",
      "email": "[email protected]",
      "latest_status": "Contacted",
      "activity": [
        {
          "action": "InMail",
          "action_time": "2026-03-24T09:45:00.000Z"
        }
      ],
      "company_name": "Tech Mahindra",
      "location": "Pune",
      "job_title": "Product Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample2.jpg"
    },
    "campaign": {
      "id": "dddddddd-2222-3333-4444-dddddddddddd",
      "name": "PM Outreach - InMail",
      "campaign_type": "linkedin",
      "total_leads": 80,
      "complete_end_of_sequence": 5
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

inmail-replied

Triggered when a prospect replies to your InMail.

{
  "event": "inmail-replied",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T16:10:00.000Z",
  "data": {
    "actionData": {
      "replay_message": "Thanks for reaching out! Can we schedule a call this week?"
    },
    "lead": {
      "id": "22222222-bbbb-cccc-dddd-222222222222",
      "name": "Priya Nair",
      "profile_url": "https://linkedin.com/in/priyanair",
      "email": "[email protected]",
      "latest_status": "Replied",
      "activity": [
        {
          "action": "InMail",
          "action_time": "2026-03-23T09:45:00.000Z"
        },
        {
          "action": "Message Replied",
          "action_time": "2026-03-24T16:10:00.000Z"
        }
      ],
      "company_name": "Tech Mahindra",
      "location": "Pune",
      "job_title": "Product Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample2.jpg"
    },
    "campaign": {
      "id": "dddddddd-2222-3333-4444-dddddddddddd",
      "name": "PM Outreach - InMail",
      "campaign_type": "linkedin",
      "total_leads": 80,
      "complete_end_of_sequence": 5
    },
    "sender": {
      "id": "aaaaaaaa-1111-2222-3333-aaaaaaaaaaaa",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

Email Events


email-sent

Triggered when an email is successfully delivered.

{
  "event": "email-sent",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T08:30:00.000Z",
  "data": {
    "actionData": {
      "subject": "Quick question about your current stack",
      "message": "<p>Hi Amit,</p><p>Hope you're doing well! I wanted to reach out...</p>",
      "messageId": "b8c9d0e1-f2a3-4567-1234-56789abcdef0"
    },
    "lead": {
      "id": "33333333-cccc-dddd-eeee-333333333333",
      "name": "Amit Joshi",
      "profile_url": "https://linkedin.com/in/amitjoshi",
      "email": "[email protected]",
      "latest_status": "Completed",
      "activity": [
        {
          "action": "Send Email",
          "action_time": "2026-03-24T08:30:00.000Z"
        }
      ],
      "company_name": "Wipro",
      "location": "Hyderabad",
      "job_title": "Engineering Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample3.jpg"
    },
    "campaign": {
      "id": "eeeeeeee-3333-4444-5555-eeeeeeeeeeee",
      "name": "Cold Email - EM Segment",
      "campaign_type": "email",
      "total_leads": 200,
      "complete_end_of_sequence": 34
    },
    "sender": {
      "id": "bbbbbbbb-2222-3333-4444-bbbbbbbbbbbb",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

email-opened

Triggered when a recipient opens the email.

{
  "event": "email-opened",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T09:05:00.000Z",
  "data": {
    "actionData": {
      "subject": "Quick question about your current stack",
      "message": "<p>Hi Amit,</p><p>Hope you're doing well! I wanted to reach out...</p>"
    },
    "lead": {
      "id": "33333333-cccc-dddd-eeee-333333333333",
      "name": "Amit Joshi",
      "profile_url": "https://linkedin.com/in/amitjoshi",
      "email": "[email protected]",
      "latest_status": "Engaged",
      "activity": [
        {
          "action": "Send Email",
          "action_time": "2026-03-24T08:30:00.000Z"
        },
        {
          "action": "Email Opened",
          "action_time": "2026-03-24T09:05:00.000Z"
        }
      ],
      "company_name": "Wipro",
      "location": "Hyderabad",
      "job_title": "Engineering Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample3.jpg"
    },
    "campaign": {
      "id": "eeeeeeee-3333-4444-5555-eeeeeeeeeeee",
      "name": "Cold Email - EM Segment",
      "campaign_type": "email",
      "total_leads": 200,
      "complete_end_of_sequence": 34
    },
    "sender": {
      "id": "bbbbbbbb-2222-3333-4444-bbbbbbbbbbbb",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

email-clicked

Triggered when a recipient clicks a link inside the email.

{
  "event": "email-clicked",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T09:07:00.000Z",
  "data": {
    "actionData": {
      "subject": "Quick question about your current stack",
      "message": "<p>Hi Amit,</p><p>Hope you're doing well! I wanted to reach out...</p>"
    },
    "lead": {
      "id": "33333333-cccc-dddd-eeee-333333333333",
      "name": "Amit Joshi",
      "profile_url": "https://linkedin.com/in/amitjoshi",
      "email": "[email protected]",
      "latest_status": "Engaged",
      "activity": [
        {
          "action": "Send Email",
          "action_time": "2026-03-24T08:30:00.000Z"
        },
        {
          "action": "Email Opened",
          "action_time": "2026-03-24T09:05:00.000Z"
        },
        {
          "action": "Link Clicked",
          "action_time": "2026-03-24T09:07:00.000Z"
        }
      ],
      "company_name": "Wipro",
      "location": "Hyderabad",
      "job_title": "Engineering Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample3.jpg"
    },
    "campaign": {
      "id": "eeeeeeee-3333-4444-5555-eeeeeeeeeeee",
      "name": "Cold Email - EM Segment",
      "campaign_type": "email",
      "total_leads": 200,
      "complete_end_of_sequence": 34
    },
    "sender": {
      "id": "bbbbbbbb-2222-3333-4444-bbbbbbbbbbbb",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

email-replied

Triggered when a recipient replies to the email.

{
  "event": "email-replied",
  "company_id": "67787093-cc3a-44ca-8a12-5bf1afa3194c",
  "timestamp": "2026-03-24T10:45:00.000Z",
  "data": {
    "actionData": {
      "message": "Hi, thanks for reaching out! Yes, we are currently evaluating new tools."
    },
    "lead": {
      "id": "33333333-cccc-dddd-eeee-333333333333",
      "name": "Amit Joshi",
      "profile_url": "https://linkedin.com/in/amitjoshi",
      "email": "[email protected]",
      "latest_status": "Completed",
      "activity": [
        {
          "action": "Send Email",
          "action_time": "2026-03-24T08:30:00.000Z"
        },
        {
          "action": "Email Opened",
          "action_time": "2026-03-24T09:05:00.000Z"
        },
        {
          "action": "Link Clicked",
          "action_time": "2026-03-24T09:07:00.000Z"
        },
        {
          "action": "Mail Replied",
          "action_time": "2026-03-24T10:45:00.000Z"
        }
      ],
      "company_name": "Wipro",
      "location": "Hyderabad",
      "job_title": "Engineering Manager",
      "profile_image": "https://media.licdn.com/dms/image/sample3.jpg"
    },
    "campaign": {
      "id": "eeeeeeee-3333-4444-5555-eeeeeeeeeeee",
      "name": "Cold Email - EM Segment",
      "campaign_type": "email",
      "total_leads": 200,
      "complete_end_of_sequence": 34
    },
    "sender": {
      "id": "bbbbbbbb-2222-3333-4444-bbbbbbbbbbbb",
      "name": "Ravi Mehta",
      "email": "[email protected]"
    }
  }
}

Notes

  • Payload fields may vary slightly depending on the event type

  • Some fields may be null if data is unavailable

  • Timestamps are always in UTC (ISO 8601 format)

  • Additional metadata may be included for debugging or traceability


Best Practices for Parsing Payloads

  • Always rely on the event field to determine event type

  • Do not hardcode assumptions about optional fields

  • Store raw payloads for debugging and replay

  • Ensure your system handles duplicate webhook deliveries