Push API
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 lead { "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" } }