---
title: Person Payload
slug: docs/person-payload
createdAt: 2023-03-09T01:24:56.000Z
---



## Overview

When a person is added to an event, an SNS message is published to a Jomablue-owned topic and the value of the SNS ‘message’ will contain the following structure. This is also published if any edits to the Person are made, or the person checks in to an event (has their badge printed).&#x20;

### Attributes

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



- `resource_type`   string
  Must be ‘person’.&#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.
- `identifiers`   **object**
  - `first_name`   string
    Alphanumeric (upper and lower case), special characters and whitespace.
  - `last_name`   string
    Alphanumeric (upper and lower case), special characters and whitespace.
  - `email`   string
    A correctly formatted email address. Can be empty.
  - `phone`  string
    Alphanumeric (upper and lower case), special characters and whitespace. Can be empty.
  - `company`  string
    Alphanumeric (upper and lower case), special characters and whitespace. Can be empty.
  - `id`  string
    A unique identifier. Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
  - `organisation_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;
- `data`   **object**
  - `job_title` string
    Alphanumeric (upper and lower case), special characters and whitespace. Can be empty.
  - `cancelled`  boolean
    true or false
  - `checked_in`  boolean
    true or false
  - `first_check_in`  timestamp
    Timestamp in the following format: 2025-07-02T19:15:12.511Z
  - `import_type`  string
    Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace.
  - `updated_at`  timestamp
    Timestamp in the following format: 2025-07-02T19:15:12.511Z
  - `created_at`  timestamp
    Timestamp in the following format: 2025-07-02T19:15:12.511Z
  - `custom_fields`  **array&#xD;**&#xA;May be empty
    - `custom_fields.[].key` string
      Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace
    - `custom_fields.[].value` string
      Alphanumeric (upper and lower case), special characters and whitespace.
  - `categories`  **array**
    - `categories.[].id` string
      Alphanumeric (upper and lower case), hyphens, forward slash and underscores. No whitespace
    - `categories.[].name` string

***

### Sample Payload

A sample Person payload can be found below:

:::CodeblockTabs
person

```json
{
  "resource_type": "person",
  "generated_at": "2025-01-28T04:45:34.089026Z",
  "context": {
    "event_id": "acme/event/123",
    "event_name": "Sonic Conference 2025",
    "event_metadata": {
      "text": "anything",
      "selector": "option2",
      "predefined": "predefinedValue"
    }
  },
  "identifiers": {
    "first_name": "Catherine",
    "last_name": "Lebsack",
    "email": "catherine.lebsack@example.com",
    "phone": "+61491570006",
    "company": "Barrows, Heaney and Watsica",
    "id": "acme/event_person/123",
    "organisation_uid": "4ab9ecb4-91cd-34ba-928e-b6d929b81a1c"
  },
  "data": {
    "job_title": "CEO",
    "cancelled": false,
    "checked_in": false,
    "first_check_in": null,
    "import_type": "import",
    "updated_at": "2025-01-28T04:45:34.089026Z",
    "created_at": "2025-01-28T04:45:34.089026Z",
    "custom_fields": [
      {
        "key": "dietary_requirements",
        "value": "None"
      },
      {
        "key": "company_size",
        "value": "500-999"
      },
      {
        "key": "primary_interest",
        "value": "Technology"
      }
    ],
    "categories": [
      {
        "id": "acme/category/1231",
        "name": "Delegate"
      },
      {
        "id": "acme/category/1232",
        "name": "VIP"
      }
    ]
  }
}
```
:::



## Triggering a Person Payload

An example of how to trigger this payload:



1. Log in to your instance of Jomablue
2. Select an event (if prompted)
3. Navigate to People
4. Add a new person or edit and existing and press Save



