# MAILING_ENABLED

Canonical page: https://docs.ovok.com/settings-and-features/settings/mailing-enabled

A reserved Boolean setting. Ovok accepts and stores it, but **no Ovok route reads it today**: turning it on or off changes nothing.

| | |
| --- | --- |
| Type | Boolean setting |
| Change with | `PUT /v1/project/settings/MAILING_ENABLED` |
| Who can change it | Project admin |
| When unset | Reads as `false`; the value has no effect either way |
| Set on new projects | Not set by any project-creation route |
| Effect today | None |

## Why it is listed [#why-it-is-listed]

`MAILING_ENABLED` is one of the keys that `GET /v1/project/settings` returns and `PUT /v1/project/settings/:key` accepts. It appears in the `settings` record of every project, so dashboards and generated clients see it. Do not use it to switch email on or off.

```bash
curl --get 'https://api.sandbox.ovok.com/v1/project/settings' \
  --header "Authorization: Bearer ${OVOK_TOKEN}"
```

## What actually controls email [#what-actually-controls-email]

| Email | What controls it |
| --- | --- |
| Email sent by an automation (Bot) | The [email](/settings-and-features/features/email) project feature. |
| Invitations, password resets and other messages Ovok sends itself | No project switch. They are sent when the template is [mapped](/email-templates/map-templates) and its provider is `ready`. See [Email templates](/email-templates). |

If Ovok cannot send an invitation email, most invitation routes undo the invitation rather than leave an account nobody can reach, and report it differently: `POST /auth/invite` and `POST /v1/saas/register` answer `500`, an admin invite fails in the Console, and `POST /v1/invites/*` still answers `202`. `POST /v1/slim/invite/practitioner` is the exception: it creates the account and succeeds even when no email could be sent. See [PATIENT_INVITATION_ENABLED](/settings-and-features/settings/patient-invitation-enabled) and [PRACTITIONER_INVITATION_ENABLED](/settings-and-features/settings/practitioner-invitation-enabled).

To control **where** the links in those emails point, set [PATIENT_APP_URL](/settings-and-features/settings/patient-app-url) and [PRACTITIONER_APP_URL](/settings-and-features/settings/practitioner-app-url).

## Gotchas [#gotchas]

- **A `true` value is not a promise.** Setting it does not enable mailing, and setting it to `false` does not stop mail.
- **Do not build your own logic on it.** Its meaning is not defined, so treat the current value as meaningless.
- **Writes still follow the normal rules.** Admin only, and a concurrent change answers `409`; read the settings again and retry.

## Related [#related]

- [Email templates](/email-templates), which choose what Ovok's own emails say
- [email feature](/settings-and-features/features/email)
- [CONTENT_ENABLED](/settings-and-features/settings/content-enabled)
- [Settings and features](/settings-and-features#reserved-settings)
