Skip to content
Upvio Developer Docs

Create a Booking Event Template

POST
/businesses/{businessId}/notifications/booking-event-templates

Create a new booking event notification template.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
businessId
required

The ID of the Business.

string

Request Body required

Section titled “Request Body required ”
Booking Event Template Create Input
object
event
required

The booking event that triggers this notification.

string
Allowed values: APPOINTMENT_CREATED APPOINTMENT_UPDATED APPOINTMENT_DELETED RECURRING_APPOINTMENT_CREATED RECURRING_APPOINTMENT_UPDATED RECURRING_APPOINTMENT_DELETED
type
required

The type of notification (EMAIL or SMS).

string
Allowed values: EMAIL SMS
recipient
required

The recipient of the notification.

string
Allowed values: BUSINESS_OWNER GUESTS PATIENT STAFF
serviceIds

The IDs of the services this template applies to. Defaults to an empty array (all services).

Array<string>
messageTemplate

Custom message template override.

object
type
required

The message template type.

string
Allowed values: email sms
subject
required

The email subject line.

string
content
required

The message content with template variables.

string

Responses

Section titled “ Responses ”

201

Section titled “201 ”

The created Booking Event Template.

object
data
object
id

Unique identifier across the platform.

string format: uuid
createdAt

Time when the resource was created (ISO 8601 format).

string format: date-time
updatedAt

Time when the resource was last updated (ISO 8601 format).

string format: date-time
businessId

The ID of the business this template belongs to.

string format: uuid
serviceIds

The IDs of the services this template applies to. An empty array means all services.

Array<string>
event

The booking event that triggers this notification.

string
type

The type of notification (EMAIL or SMS).

string
Allowed values: EMAIL SMS
recipient

The recipient of the notification.

string
enabled

Whether this template is enabled.

boolean
messageTemplate

Custom message template override. Null if using the default.

object
id

The unique identifier for the message template.

string
type

The message template type.

string
Allowed values: email sms
subject

The email subject line.

string
content

The message content with template variables.

string
defaultTemplate

The default message template for this event, type, and recipient combination.

object
id

The unique identifier for the message template.

string
type

The message template type.

string
Allowed values: email sms
subject

The email subject line.

string
content

The message content with template variables.

string

400

Section titled “400 ”

Invalid input.

object
error
object
code
number
Example
404
title
string
Example
Not Found