Skip to content

Retrieve a Booking Event Template

GET
/businesses/{businessId}/notifications/booking-event-templates/{bookingEventTemplateId}
curl --request GET \
--url https://api.upvio.com/v1/businesses/example/notifications/booking-event-templates/example \
--header 'Authorization: Bearer <token>'

Retrieve a booking event notification template by ID.

businessId
required

The ID of the Business.

string
bookingEventTemplateId
required

The ID of the Booking Event Template.

string

A Booking Event Template.

Media typeapplication/json
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

Example

{
"data": {
"type": "EMAIL",
"messageTemplate": {
"type": "email"
},
"defaultTemplate": {
"type": "email"
}
}
}

The booking event template ID is malformed.

Media typeapplication/json
object
error
object
code
number
type

The specific error that occurred.

string
Allowed values: BadRequestError
title

Human-readable description of the error.

string

Example

{
"error": {
"code": 400,
"type": "BadRequestError",
"title": "Invalid platformId format."
}
}

The API key is missing or invalid, or the Business cannot be accessed with it.

Media typeapplication/json
object
error
object
code
number
type

The specific error that occurred.

string
Allowed values: UnauthorizedError BusinessArchivedError BusinessDisabledError
title

Human-readable description of the error.

string

Example

{
"error": {
"code": 403,
"type": "UnauthorizedError",
"title": "Invalid API token"
}
}

The booking event template does not exist.

Media typeapplication/json
object
error
object
code
number
type

The specific error that occurred.

string
Allowed values: NotFoundError BusinessNotFoundError
title

Human-readable description of the error.

string

Example

{
"error": {
"code": 404,
"type": "NotFoundError",
"title": "Booking Event Template not found"
}
}