List text templates

list_site_message_templates

Lists a site's text templates, built-in and its own, with each one's text and review state.

POST /v1/list_site_message_templatesScopeconfig:readRead only

Every site starts with the built-in templates, and custom marks the ones it added of its own. Each has its key, label, category (UTILITY for an update, MARKETING for a promotion, AUTHENTICATION for the verification code), text with {{placeholders}}, its fields with examples, and its state: initial (not sent for review yet), pending (in review), approved (it can send real texts), rejected, paused or disabled. reason carries why the review rejected or paused it, or why sending it for review failed. retrying true means the review could not start for a reason outside the template, such as the site's texting account not being ready yet, and it is sent for review again on its own, so it needs nothing more. canEdit, canSubmit and canDelete say what can be done with it now. See Templates.

Request

Call it with a POST to https://api.modulify.ai/v1/list_site_message_templates, sending the inputs below as a JSON object. The token needs the config:read scope.

It only reads and changes nothing, so retrying it is safe.

curl -X POST https://api.modulify.ai/v1/list_site_message_templates \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'

Over MCP, the same method is the list_site_message_templates tool.

Inputs

Input Type Required Description
projectId string Yes The site id.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.