The StaffNotification Object

An instance of a notification sent to a staff member, including delivery content and statuses.

Properties

NameDescriptionTypeRequired
uidThe unique identifier of the staff notification.stringYes
staff_uidThe unique identifier of the staff member associated with this notification.stringYes
notification_template_code_nameThe code name identifying the notification template to be used.stringYes
localeThe language locale for the notification content.string (enum: en, fr, de, it, pl, pt, es, nl, he, sl, en_gb)Yes
paramsAdditional parameters for populating notification templates.array of objects
staff_portal_contentSettings for pane notificationsobject
email_contentSettings for email notificationsobject
push_statusThe current delivery status of the push notification.string (enum: sent, failed)
pane_statusThe current delivery status of the pane notification.string (enum: sent, read, failed)
email_statusHistory of delivery statuses for the email notification. Each entry represents a status the notification has passed through, in chronological order.array of strings
created_atThe date and time when the staff notification was created, in ISO 8601 format.stringYes
updated_atThe date and time when the staff notification was last updated, in ISO 8601 format.stringYes

Staff Portal Content Properties

NameDescriptionTypeRequired
titleTitle for the notification.stringYes
message_bodyMessage body for the notification.stringYes
deep_linkOptional deep link URL for notification action.string

Email Content Properties

NameDescriptionTypeRequired
subjectEmail subject line.stringYes
top_imageImage at the top of the email.object
main_titleHeader or introduction text for the email.stringYes
main_textMain content of the email.stringYes
middle_imageImage in the middle of the email.object
middle_textMiddle content of the email.string
footer_textFooter or closing text for the email.string
primary_cta_buttonCall-to-action button details.object
secondary_cta_buttonSecondary call-to-action button details.object

Example

JSON

{
  "uid": "staff-notification-12345",
  "staff_uid": "staff-67890",
  "notification_template_code_name": "new_appointment_created",
  "locale": "en",
  "params": [
    {
      "key": "client_name",
      "value": "John Doe"
    },
    {
      "key": "appointment_time",
      "value": "2023-05-15T14:30:00Z"
    }
  ],
  "staff_portal_content": {
    "title": "New appointment",
    "message_body": "You have a new appointment",
    "deep_link": "/appointments/12345"
  },
  "email_content": {
    "subject": "Appointment Confirmation",
    "main_title": "Your appointment is confirmed!",
    "main_text": "Thank you for booking with us. Your appointment is scheduled.",
    "footer_text": "If you have questions, contact us anytime."
  },
  "push_status": "sent",
  "pane_status": "read",
  "email_status": [
    "delivered",
    "open"
  ],
  "created_at": "2023-05-10T09:00:00Z",
  "updated_at": "2023-05-10T09:05:00Z"
}