Event - User Notification
This event is generated when a guest signs up in the Punchh system via the mobile app. These events are triggered as they happen in the Punchh system based on configuration.
{
"content_id": "CONTENT_ID_GOES_HERE",
"timestamp": 1619694452,
"business_id": 6,
"business_uuid": "BUSINESS_UUID_GOES_HERE",
"business_slug": "slugname",
"event_name": "transactional_notifications",
"event_type": "user_signup",
"action": "create",
"payload": {
"account_balance": {
"banked_currency": null,
"current_membership_level_name": "Gold",
"last_visit": "2023-04-29T07:00:33Z",
"loyalty_points": 60,
"net_balance": 20,
"net_debits": 100,
"pending_points": 0,
"total_credits": 120,
"total_debits": "100.0",
"total_lifetime_points": 120,
"total_point_credits": 120,
"total_redeemable_visits": null,
"total_visits": 3,
"unbanked_points": null,
"unredeemed_cards": null,
"user_id": 5752
},
"anniversary": null,
"avatar_remote_url": null,
"birthday": null,
"email": "test@example.com",
"email_confirmation_url": "EMAIL_CONFIRMATION_URL_GOES_HERE",
"external_source_id": "SOURCE_ID_GOES_HERE",
"first_name": "FIRST_NAME_GOES_HERE",
"gender": "Male",
"guest_type": "Loyalty",
"last_activity_at": "2023-04-29T07:00:33Z",
"last_name": "LAST_NAME_GOES_HERE",
"marketing_email_subscription": true,
"marketing_pn_subscription": true,
"phone": "1111111111",
"preferred_locale": "en",
"reset_password_url": null,
"secondary_email": "test1@example.com",
"signup_channel": "MobileEmail",
"sms_subscription": false,
"unsubscribe_reason": null,
"unsubscribed": false,
"user_id": 5752,
"user_status": "active"
}
}
Meta Fields
Meta Fields are common attributes such as content_id, timestamp, etc. that are returned in event responses, providing additional information about events. Click here to view the descriptions of the attributes.
Response Parameters
| Payload | ||
| account_balance | Object | See the account_balance object in Event - Guest |
| anniversary | Date | Anniversary date of the end-user in YYYY-MM-DD format |
| avatar_remote_url | String | Avatar remote URL |
| birthday | Date | Birthday of the user in YYYY-MM-DD format |
| String | Email address of the user | |
| email_confirmation_url | String | Email confirmation URL |
| external_source_id | String | Returns the ID stored in Punchh against the external source. If external_source is not being used or is blank, then by default it will return Punchh user_id. |
| first_name | String | First name of the user |
| gender | String | Gender of the user |
| guest_type | String | Type of the user (i.e., eClub or loyalty) |
| last_activity_at | Date_time | User’s last activity timestamp |
| last_name | String | Last name of the user |
| marketing_email_subscription | Boolean | Whether the end-user has subscribed to marketing emails or not |
| marketing_pn_subscription | Boolean | Whether the end-user has subscribed to marketing push notifications or not |
| phone | String | Phone number of the user |
| preferred_locale | String | Preferred language |
| reset_password_url | String | Reset password URL |
| secondary_email | String | Secondary email of the user is configured when a user signs up with Facebook but does not share the email address. The app asks for an alternate email address, which is kept as the secondary_email. |
| signup_channel | String | Sign-up channel of the user |
| sms_subscription | Boolean | Whether the end-user has subscribed to SMS services or not |
| unsubscribe_reason | String | Unsubscribe reason |
| unsubscribed | Boolean | Unsubscribe status |
| user_id | Integer | User ID generated by the Punchh system |
| user_status | String | Status of the user (i.e., active, banned, or deactivated) Note: Punchh does not send guest events for users with deleted, anonymized, or archived status, as personally identifiable information (PII) is not stored once a guest is moved into these statuses. |