Create a reminder template

Create an appointment reminder template. created_by is set to the user who created the API key.

POST https://api.centerfy.ai/webhooks/inbound/reminder-templates

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your sub-account API key (cfy_…)	Authenticates the request; or use Authorization: Bearer `<key>`.

Body parameters

Name	Type	Required	Default	Description
`name`	`string`	Yes	—	Template name (max 200 characters).
`message`	`string`	Yes	—	Reminder text (max 5000 characters).
`channels`	`string[]`	No	—	Any of email, sms, without repeats. Defaults to [].
`reminder_time`	`integer`	No	—	Minutes before the appointment; 0 to 43200 (30 days). Defaults to 1440 (24 hours).
`timezone`	`string`	No	—	IANA timezone name, e.g. America/New_York. Defaults to UTC.
`use_contact_timezone`	`boolean`	No	—	Use the contact’s timezone instead of timezone. Defaults to false.

Request body

{
  "name": "Day-before reminder",
  "message": "Hi! Just a reminder about your appointment tomorrow.",
  "channels": [
    "email",
    "sms"
  ],
  "reminder_time": 1440,
  "timezone": "America/New_York"
}

Example

curl -X POST "https://api.centerfy.ai/webhooks/inbound/reminder-templates" \
  -H "x-api-key: $CENTERFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Day-before reminder",
  "message": "Hi! Just a reminder about your appointment tomorrow.",
  "channels": [
    "email",
    "sms"
  ],
  "reminder_time": 1440,
  "timezone": "America/New_York"
}'

import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.reminderTemplates.create({
  "name": "Day-before reminder",
  "message": "Hi! Just a reminder about your appointment tomorrow.",
  "channels": [
    "email",
    "sms"
  ],
  "reminder_time": 1440,
  "timezone": "America/New_York"
});
console.log(result);

centerfy reminderTemplates create '{"name":"Day-before reminder","message":"Hi! Just a reminder about your appointment tomorrow.","channels":["email","sms"],"reminder_time":1440,"timezone":"America/New_York"}'

MCP tool: centerfy_reminder_templates_create (see MCP server)

Response

{
  "status": "success",
  "reminder_template": {
    "id": "4e5f6a7b-8c9d-4e0f-8a1b-2c3d4e5f6a7b",
    "name": "Day-before reminder",
    "message": "Hi! Just a reminder about your appointment tomorrow.",
    "channels": [
      "email",
      "sms"
    ],
    "reminder_time": 1440,
    "timezone": "America/New_York",
    "use_contact_timezone": false,
    "created_by": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "created_at": "2026-10-01T10:00:00.000Z",
    "updated_at": "2026-10-01T10:00:00.000Z"
  }
}

Errors

400 — if name or message is empty, timezone is not a valid IANA name, or a field is out of range.

Notes

Returns 201.