{type}. Message content, channels, and delivery rules are platform-managed. Free-form message content is not accepted. Request fields are limited to those documented below.200 may return "success": false when the request is accepted but delivery does not complete (for example, the customer is unsubscribed). Authentication and client errors use non-2xx responses.403.{type} valuestype | Purpose | Required body |
|---|---|---|
booking-confirmation | Customer booking confirmation for an active booking | bookingId |
booking-update | Customer booking update for the current booking state | bookingId |
booking-reminder | Booking appointment reminder | bookingId |
review-invitation | Review invitation | customerId or phone; bookingId optional |
service-reminder | Service reminder for a done booking (send now or schedule) | bookingId; reminderAt optional |
type values return 400 with error code 000001.booking-confirmation / booking-updatebookingId is required and must belong to the workshop.done or cancelled.channels as { type: "sms", success, sentAt, message }, plus conversationId / messageId when available.booking-reminderbookingId is required and must belong to the workshop.review-invitationcustomerId or phone is required. When customerId is omitted, phone is required.customerId is provided, it must exist under the workshop.bookingId is provided, it must belong to the workshop and to the resolved customer."success": true with withinSixMonths: true and without a new SMS send.service-reminderbookingId is required. The booking must be done and eligible for a service reminder.reminderAt is omitted, the reminder is sent immediately.reminderAt is provided, the reminder is scheduled for that datetime and is not sent immediately. Invalid datetime values return 400.400.404.200, "success": false)channels is present, top-level success is false if any channel has success: false. Top-level success is true only when every channel has success: true. Clients should inspect success, channels, and optional message.| Business event | type |
|---|---|
| New booking confirmation | booking-confirmation |
| Booking details changed | booking-update |
| Appointment reminder | booking-reminder |
| Post-service review request | review-invitation |
| Post-service follow-up (immediate or scheduled) | service-reminder |
| HTTP | errorCode | When |
|---|---|---|
| 400 | 000001 | Missing or invalid body fields, unsupported type, invalid reminderAt, or booking not eligible for service reminder |
| 400 | 060002 | Booking status not allowed for the requested automation |
| 401 | 010000 | Missing or invalid OAuth token |
| 403 | 000003 | Feature unavailable |
| 403 | 000004 | Partner integration, inbox messaging, or inbox phone not ready for the workshop |
| 404 | 030001 | Workshop not found |
| 404 | 040001 | Customer not found |
| 404 | 050001 | Related resource not found |
| 404 | 060001 | Booking not found for the workshop |
| 404 | 000001 | Required booking-related resource not found |