Lead Payload
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.
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’.
- 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.
- vendor_id string A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
- vendor_name string Alphanumeric (upper and lower case), special characters and whitespace. May change through an event.
- 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.
- identifiers object
- id string A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
- 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.
- created_at timestamp Timestamp in the following format: 2025-07-02T19:15:12.511Z
Sample Payload
A sample of an lead payload is below.
{
"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": "[email protected]",
"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"
}
}