---
title: "Create or update event email settings"
method: POST
path: "/organizations/{organizationId}/event-email-settings/{context}/{mode}"
tags: ["Event Email Settings"]
---

# Create or update event email settings

`POST /organizations/{organizationId}/event-email-settings/{context}/{mode}`

Creates or updates event email settings for a specific context and mode

## Path parameters

- `context` 'practitioner' | 'facility', required
- `mode` 'credentialing' | 'recredentialing', required
- `organizationId` string, required

## Headers

- `tenant-id` string, required

## Request body

- EventEmailSettingsRequest — Request to create or update event email settings. Context and mode are specified in the URL path.
  - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Recipient preferences for event emails
    - `primaryEmail` boolean — Send to primary email
    - `caqhPrimaryEmail` boolean — Send to CAQH primary email
    - `credentialingPrimaryContact` boolean — Send to credentialing primary contact
    - `credentialingOfficeManager` boolean — Send to credentialing office manager
  - `ccEmail` string — Global CC email applied to all event emails for this context and mode
  - `typeSettings` EventEmailTypeSettingsDto[], required — Settings for each event type (should include all 5 types)
    - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady', required — Event email type
    - `template` EventEmailTemplateDto, required — Event email template with subject and body
      - `subject` string, required — Email subject line
      - `bodyHtml` string, required — Email body HTML content
    - `enabled` boolean, required — Whether this event email type is enabled

## Response `200`

Event email settings created/updated successfully

- EventEmailSettingsResponse — Event email settings response
  - `context` 'practitioner' | 'facility', required — Context (practitioner or facility)
  - `mode` 'credentialing' | 'recredentialing', required — Mode (credentialing or recredentialing)
  - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Recipient preferences for event emails
    - `primaryEmail` boolean — Send to primary email
    - `caqhPrimaryEmail` boolean — Send to CAQH primary email
    - `credentialingPrimaryContact` boolean — Send to credentialing primary contact
    - `credentialingOfficeManager` boolean — Send to credentialing office manager
  - `ccEmail` string — Global CC email applied to all event emails for this context and mode
  - `logoUrl` string — Logo URL applied to all event emails for this context and mode
  - `logoWidth` string — Logo width applied to all event emails for this context and mode
  - `typeSettings` EventEmailTypeSettingsDto[], required — Settings for each event type
    - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady', required — Event email type
    - `template` EventEmailTemplateDto, required — Event email template with subject and body
      - `subject` string, required — Email subject line
      - `bodyHtml` string, required — Email body HTML content
    - `enabled` boolean, required — Whether this event email type is enabled

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `500` — Internal Server Error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/versions/3d27e9019c7b/schema)