---
title: Lead Payload
slug: docs/lead-payload
createdAt: 2025-01-20T09:05:45.387Z
---

## Overview

When a person is captured as a lead by a Vendor (ie, scans their badge at a Sponsor, Exhibitor, Stand, Booth etc) a SNS message is published to a Jomablue-owned topic and the value of the SNS ‘message’ will contain the following structure. Messages are pushed when a vendor captures a lead using a lead capture device.

A description of each attribute in the Vendor Lead payload can be found below.

:::hint{type="info"}
It's common for Vendors Names to change - we recommend using ID's over matching Strings/Vendor Names
:::



### Attributes

A description of each attribute in the Lead payload can be found below:



- `resource_type`   string
  Must be ‘lead’.&#x20;
- `generated_at`   timestamp
  Timestamp in the following format: 2025-07-02T19:15:12.511Z.
- `context`  **object**
  - `event_id`   string
    A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
  - `event_name`   string
    Alphanumeric (upper and lower case), special characters and whitespace.
  - `event_metadata`   object
    Keys must only contain alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
    Values can contain Alphanumeric (upper and lower case), special characters and whitespace.
  - `person_first_name` string
    Alphanumeric (upper and lower case), special characters and whitespace.
  - `person_last_name` string
    Alphanumeric (upper and lower case), special characters and whitespace.
  - `person_email` string
    A correctly formatted email address. May contain an empty value.
  - `person_phone` string
    Alphanumeric (upper and lower case), special characters and whitespace. May contain an empty value.
  - `person_company`  string
    Alphanumeric (upper and lower case), special characters and whitespace. May contain an empty value.
  - `person_id` string
    A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
  - `person_organisation_uid` string
    A unique identifier provided from external systems to Jomablue (eg: A Salesforce Lead/Contact ID). Alphanumeric (upper and lower case), hyphens, forward slash and underscores.&#x20;
  - `vendor_id` string
    A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.&#x20;
  - `vendor_name` string
    Alphanumeric (upper and lower case), special characters and whitespace. May change through an event.&#x20;
  - `vendor_organisaion_uid` string
    A unique identifier provided from external systems to Jomablue (eg: A Salesforce campaign ID). Alphanumeric (upper and lower case), hyphens, forward slash and underscores.&#x20;
- `identifiers`  **object**
  - `id`   string
    A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.&#x20;
- `data` object
  - `updated_at` timestamp
    Timestamp in the following format: 2025-07-02T19:15:12.511Z. Will match created\_at if not updates have been applied.&#x20;
  - `created_at` timestamp
    Timestamp in the following format: 2025-07-02T19:15:12.511Z



***

### Sample Payload

A sample of an lead payload is below.&#x20;

:::CodeblockTabs
lead

```json
{
  "resource_type": "lead",
  "generated_at": "2025-01-28T04:27:07.476819Z",
  "context": {
    "event_id": "acme/event/123",
    "event_name": "Sonic Conference 2025",
    "event_metadata": {
      "text": "anything",
      "selector": "option2",
      "predefined": "predefinedValue"
    },
    "person_first_name": "Catherine",
    "person_last_name": "Lebsack",
    "person_email": "catherine.lebsack@example.com",
    "person_phone": "+61491570006",
    "person_company": "Barrows, Heaney and Watsica",
    "person_id": "acme/event_person/123",
    "person_organisation_uid": "4ab9ecb4-91cd-34ba-928e-b6d929b81a1c",
    "vendor_id": "acme/vendor/123",
    "vendor_name": "Jomablue",
    "vendor_organisation_uid": "aac8b206-0d5f-4a71-97b5-f2326a74ed1c"
  },
  "identifiers": {
    "id": "acme/lead/123"
  },
  "data": {
    "updated_at": "2025-01-28T04:27:07.476819Z",
    "created_at": "2025-01-28T04:27:07.476819Z"
  }
}
```
:::

