Update a reminder template

Update a reminder template. Only the fields you send change.

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

Headers

HeaderRequiredValueDescription
x-api-keyYesyour sub-account API key (cfy_…)Authenticates the request; or use Authorization: Bearer <key>.

Path parameters

NameTypeRequiredDescription
idstring (uuid)YesThe reminder template id.

Body parameters

NameTypeRequiredDefaultDescription
namestringNo—New name (max 200 characters); cannot be empty.
messagestringNo—New reminder text (max 5000 characters); cannot be empty.
channelsstring[]No—Any of email, sms, without repeats. Replaces the current list.
reminder_timeintegerNo—Minutes before the appointment; 0 to 43200 (30 days).
timezonestringNo—IANA timezone name, e.g. America/New_York.
use_contact_timezonebooleanNo—Use the contact’s timezone instead of timezone.

Request body

{
  "reminder_time": 120,
  "channels": [
    "sms"
  ]
}

Example

curl -X PATCH "https://api.centerfy.ai/webhooks/inbound/reminder-templates/{id}" \
  -H "x-api-key: $CENTERFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reminder_time": 120,
  "channels": [
    "sms"
  ]
}'
import { CenterfyClient } from "@centerfy/sdk";

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

const result = await centerfy.reminderTemplates.update("<templateId>", {
  "reminder_time": 120,
  "channels": [
    "sms"
  ]
});
console.log(result);
centerfy reminderTemplates update <templateId> '{"reminder_time":120,"channels":["sms"]}'

MCP tool: centerfy_reminder_templates_update (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": [
      "sms"
    ],
    "reminder_time": 120,
    "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-04T09:00:00.000Z"
  }
}

Errors

  • 400 — if name or message is empty, or timezone is not a valid IANA name.
  • 404 — if the template is not in this sub-account.

Notes

Send at least one field.

© 2026 Centerfy AI. All rights reserved.