# PROVIDER MISMATCH

Canonical page: https://docs.ovok.com/errors/provider-mismatch

**HTTP 409.** Stable Problem Details type: [`https://docs.ovok.com/errors/provider-mismatch`](https://docs.ovok.com/errors/provider-mismatch).

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

The template mapping provider does not match the provider configured for the project. Clients should branch on `type` and `status`, not on human-readable `detail` text.

## Troubleshooting [#troubleshooting]

Read provider and mapping together, including language and domain. Do not assume mappings transfer between provider implementations. 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.