# INVALID TEMPLATE CONTENT

Canonical page: https://docs.ovok.com/errors/invalid-template-content

**HTTP 422.** Stable Problem Details type: [`https://docs.ovok.com/errors/invalid-template-content`](https://docs.ovok.com/errors/invalid-template-content).

## What this means [#what-this-means]

Template content does not satisfy the selected email provider's requirements. Clients should branch on `type` and `status`, not on human-readable `detail` text.

## Troubleshooting [#troubleshooting]

Check name, language, domain, subject and HTML requirements. SMTP requires subject and HTML; managed providers can reject those fields. Compare the request with the relevant endpoint's documentation and confirm the authenticated project and environment. Record the request path and `traceId` before escalating; the identifier lets an administrator find server-side context without sharing credentials or patient data.

## Related endpoint guidance [#related-endpoint-guidance]

Use these pages to check the route, project settings, and request requirements associated with this error:

- [Map email templates](/email-templates/map-templates)
- [Email troubleshooting](/email-templates/troubleshooting)

## Retry safely [#retry-safely]

Correct the request, configuration, access or project state described above before retrying. Repeating an unchanged request will normally return the same error; for writes, check whether the first attempt changed state before sending it again. Follow endpoint-specific idempotency and concurrency guidance. Do not retry in a tight loop or use a broader permission or project setting to bypass the check.

## If the problem persists [#if-the-problem-persists]

Share the HTTP status, problem `type`, request path, response timestamp, and `traceId` with your administrator or support contact. Remove access tokens, provider secrets, and sensitive patient data from the report. The [Error responses guide](/errors) explains the response fields, while the [machine-code registry](/errors/machine-codes) lists every endpoint-specific type audited for this release.