Support Inbox

Create a saved reply

curl -X POST https://api.subscriby.net/v1/projects/$PROJECT_ID/support/canned-replies \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Opening hours",
    "body": "We answer between 9 and 5, Monday to Friday.",
    "shortcut": "hours"
  }'

Answers 201 with the snippet and emits support.canned_reply.created.

A duplicate shortcut is a 422, not a second snippet. Shortcuts are unique per project. Sending a shortcut another saved reply on the same project already uses is refused on shortcut. Two different projects may both have hours.

post/v1/projects/{project}/support/canned-replies

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/support/canned-replies
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Request body

titlestring required

The label shown in the picker, 2 to 80 characters; never sent to the member.

bodystring required

The text sent to the member, 2 to 4,000 characters, the message ceiling the reply has to fit once it is sent.

shortcutstring nullable

Up to 30 letters, numbers, dashes and underscores, unique within the project (two projects may both have hours). Omit it, or send null or an empty string, for none. The character set means a shortcut can never be confused with a bot command or need escaping when echoed back.

sort_orderinteger

The position in the picker, 0 to 999. Defaults to 0.

Response

The snippet.

Example response

{
  "data": {
    "id": "1f7c9a3e-52d8-4b16-a0e4-8c3b7d29f615",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "title": "Opening hours",
    "body": "We answer between 9 and 5, Monday to Friday. Anything sent outside that is picked up the next working morning.",
    "shortcut": "hours",
    "created_at": "2026-09-06T10:05:00+00:00",
    "updated_at": "2026-09-06T10:05:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.