Send Message

Send a one-to-one SMS to a workshop customer through Repairy Inbox.

Use either:

free-text content in channels.sms.message, or

a published inbox SMS template via channels.sms.templateId

Identify the customer with customerId, or with phone when customerId is omitted (find or create). Optionally pass bookingId when the template needs booking context. Use referenceId as an idempotency key (recommended in production).

Notes

SMS only — this endpoint does not support other channels

Template placeholders are filled by Repairy — do not send placeholder values

Get templateId values from GET /v1/workshops/{id}/templates

Always check sms.sent — top-level success matches SMS delivery (true only when sent)

Workshop must have partner integration and inbox messaging enabled

Idempotency (referenceId)

Same referenceId for the same customer:

Prior result	Behaviour
Success	Returns previous result — no new send
Failed	Attempts delivery again — returns new outcome
Omitted	Every call is a new send

Rate limit: max 5 requests/second per workshop + customer (429 when exceeded).

HTTP 200 with success: false means the request was valid but SMS was not delivered. HTTP 4xx means the request itself was rejected.

Errors

HTTP	errorCode	When
400	`000001`	Invalid body, missing SMS content, missing phone/customerId, or invalid template
400	`060001`	Booking exists but belongs to a different customer
401	`010000`	Missing or invalid OAuth token
403	`000003`	Feature unavailable
403	`000004`	Partner integration or inbox messaging disabled for the workshop
404	`030001`	Workshop not found
404	`040001`	Customer not found under this workshop
404	`060001`	Booking not found under this workshop
429	—	More than 5 requests/second for the same workshop and customer

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Free textTemplateIdempotent replay

{
  "phone": "+61412345678",
  "channels": {
    "sms": {
      "message": "Hi Jane, your car is ready for pickup after 5pm."
    }
  },
  "referenceId": "partner-msg-20260722-001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

SuccessDelivery Failure

{
  "success": true,
  "referenceId": "marlin-msg-20260722-001",
  "sms": {
    "sent": true,
    "message": "SMS sent",
    "messageId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "conversationId": "64f1a2b3c4d5e6f7a8b9c0d1"
  }
}

🟠400Bad request

🟠404Not found

🟠429Rate Limited

🟠403Feature Unavailable/Disabled

Errors#

Request

Request Code Samples

Responses

Errors