---
title: "List all event email settings for an organization"
method: GET
path: "/organizations/{organizationId}/event-email-settings"
tags: ["Event Email Settings"]
---

# List all event email settings for an organization

`GET /organizations/{organizationId}/event-email-settings`

Returns the complete event email settings envelope for the organization, covering every context (practitioner, facility) and mode (credentialing, recredentialing) combination that has been configured. The response wraps three top-level sub-objects (practitioner, facility, global); any sub-object whose settings have never been saved is returned as null rather than a 404. Use this endpoint to retrieve a full snapshot before editing individual settings, or to detect which context/mode combinations still need configuration. For a single context+mode pair, use GET /{context}/{mode} instead. The global sub-object is deprecated and always null — no write path has ever existed for it; read practitioner and facility instead. Requires TENANT_SETTINGS_EVENT_EMAIL_READ permission.

## Path parameters

- `organizationId` string, required

## Headers

- `tenant-id` string, required

## Response `200`

The organization's event email settings envelope (practitioner/facility/global), with unconfigured sub-objects returned as null.

- EventEmailSettingsConfigResponse — Full event email settings envelope for an organization, as returned by GET /organizations/{organizationId}/event-email-settings.
  - `practitioner` EventEmailSettingsContextResponse — Event email settings for one context (practitioner or facility), covering both the context-level fields (ccEmail, logoUrl, logoWidth, mmoOutcomeFilter) and both modes' settings. Returned by the context-level update endpoints (cc-email, logo-url, logo-settings, recipient-preferences, mmo-outcome-filter).
    - `ccEmail` string — Resolved CC email for this context: the context-level value if set, otherwise falling back to the credentialing mode's value, then the recredentialing mode's value. Null if none is set.
    - `logoUrl` string — Resolved logo image URL for this context, using the same context-then-credentialing-then-recredentialing fallback as ccEmail. Null if none is set.
    - `logoWidth` string — Resolved logo display width for this context, using the same fallback as ccEmail/logoUrl, as a percentage string (e.g. "50%"); no format is enforced server-side. Null if none is set.
    - `credentialing` EventEmailSettingsModeResponse — One mode's (credentialing or recredentialing) event email settings, nested inside EventEmailSettingsContextResponse. Does not repeat the context-level ccEmail/logoUrl/logoWidth fields, which live on the parent context object.
      - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Boolean flags controlling which recipient types receive event emails for a context.
        - `primaryEmail` boolean — true to send event emails to the practitioner's or facility's primary email on file; false or null to skip this recipient.
        - `caqhPrimaryEmail` boolean — true to send event emails to the CAQH-sourced primary email on file; false or null to skip this recipient.
        - `credentialingPrimaryContact` boolean — true to send event emails to the credentialing workflow's primary contact; false or null to skip this recipient.
        - `credentialingOfficeManager` boolean — true to send event emails to the office manager on the credentialing workflow; false or null to skip this recipient.
      - `typeSettings` EventEmailTypeSettingsDto[], required — One entry per configured event email type for this mode (initiated, approved, denied, cancelled, psvReady, inProgress).
        - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady' | 'inProgress', required — Which workflow event this entry configures: "initiated" (workflow started), "approved" (credentialing/recredentialing approved), "denied" (application denied), "cancelled" (workflow cancelled), "psvReady" (primary source verification complete), "inProgress" (workflow in progress).
        - `template` EventEmailTemplateDto, required — Subject and body content for one event email type's template.
          - `subject` string, required — Email subject line. Required and must be non-blank when the parent typeSettings entry has enabled: true.
          - `bodyHtml` string, required — Email body as HTML markup. Required and must be non-blank when the parent typeSettings entry has enabled: true.
        - `enabled` boolean, required — Whether an email is sent for this event type. When true, template.subject and template.bodyHtml must be non-blank.
    - `recredentialing` EventEmailSettingsModeResponse — One mode's (credentialing or recredentialing) event email settings, nested inside EventEmailSettingsContextResponse. Does not repeat the context-level ccEmail/logoUrl/logoWidth fields, which live on the parent context object.
      - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Boolean flags controlling which recipient types receive event emails for a context.
        - `primaryEmail` boolean — true to send event emails to the practitioner's or facility's primary email on file; false or null to skip this recipient.
        - `caqhPrimaryEmail` boolean — true to send event emails to the CAQH-sourced primary email on file; false or null to skip this recipient.
        - `credentialingPrimaryContact` boolean — true to send event emails to the credentialing workflow's primary contact; false or null to skip this recipient.
        - `credentialingOfficeManager` boolean — true to send event emails to the office manager on the credentialing workflow; false or null to skip this recipient.
      - `typeSettings` EventEmailTypeSettingsDto[], required — One entry per configured event email type for this mode (initiated, approved, denied, cancelled, psvReady, inProgress).
        - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady' | 'inProgress', required — Which workflow event this entry configures: "initiated" (workflow started), "approved" (credentialing/recredentialing approved), "denied" (application denied), "cancelled" (workflow cancelled), "psvReady" (primary source verification complete), "inProgress" (workflow in progress).
        - `template` EventEmailTemplateDto, required — Subject and body content for one event email type's template.
          - `subject` string, required — Email subject line. Required and must be non-blank when the parent typeSettings entry has enabled: true.
          - `bodyHtml` string, required — Email body as HTML markup. Required and must be non-blank when the parent typeSettings entry has enabled: true.
        - `enabled` boolean, required — Whether an email is sent for this event type. When true, template.subject and template.bodyHtml must be non-blank.
    - `mmoOutcomeFilter` string[] — Primary MMO (Managed Medical Outcomes) result types to send emails for. Allowed values: "Positive" (approved plan outcomes), "Negative" (denied plan outcomes). When the workflow has both approved and denied plan UDFs for the same event, the complementary outcome email is still sent regardless of this filter (e.g. filter ["Positive"] still sends the denied-plans email if present, and vice versa) — this filter narrows the primary outcome, it does not suppress the paired one. Null or empty = no restriction (both sent).
  - `facility` EventEmailSettingsContextResponse — Event email settings for one context (practitioner or facility), covering both the context-level fields (ccEmail, logoUrl, logoWidth, mmoOutcomeFilter) and both modes' settings. Returned by the context-level update endpoints (cc-email, logo-url, logo-settings, recipient-preferences, mmo-outcome-filter).
    - `ccEmail` string — Resolved CC email for this context: the context-level value if set, otherwise falling back to the credentialing mode's value, then the recredentialing mode's value. Null if none is set.
    - `logoUrl` string — Resolved logo image URL for this context, using the same context-then-credentialing-then-recredentialing fallback as ccEmail. Null if none is set.
    - `logoWidth` string — Resolved logo display width for this context, using the same fallback as ccEmail/logoUrl, as a percentage string (e.g. "50%"); no format is enforced server-side. Null if none is set.
    - `credentialing` EventEmailSettingsModeResponse — One mode's (credentialing or recredentialing) event email settings, nested inside EventEmailSettingsContextResponse. Does not repeat the context-level ccEmail/logoUrl/logoWidth fields, which live on the parent context object.
      - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Boolean flags controlling which recipient types receive event emails for a context.
        - `primaryEmail` boolean — true to send event emails to the practitioner's or facility's primary email on file; false or null to skip this recipient.
        - `caqhPrimaryEmail` boolean — true to send event emails to the CAQH-sourced primary email on file; false or null to skip this recipient.
        - `credentialingPrimaryContact` boolean — true to send event emails to the credentialing workflow's primary contact; false or null to skip this recipient.
        - `credentialingOfficeManager` boolean — true to send event emails to the office manager on the credentialing workflow; false or null to skip this recipient.
      - `typeSettings` EventEmailTypeSettingsDto[], required — One entry per configured event email type for this mode (initiated, approved, denied, cancelled, psvReady, inProgress).
        - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady' | 'inProgress', required — Which workflow event this entry configures: "initiated" (workflow started), "approved" (credentialing/recredentialing approved), "denied" (application denied), "cancelled" (workflow cancelled), "psvReady" (primary source verification complete), "inProgress" (workflow in progress).
        - `template` EventEmailTemplateDto, required — Subject and body content for one event email type's template.
          - `subject` string, required — Email subject line. Required and must be non-blank when the parent typeSettings entry has enabled: true.
          - `bodyHtml` string, required — Email body as HTML markup. Required and must be non-blank when the parent typeSettings entry has enabled: true.
        - `enabled` boolean, required — Whether an email is sent for this event type. When true, template.subject and template.bodyHtml must be non-blank.
    - `recredentialing` EventEmailSettingsModeResponse — One mode's (credentialing or recredentialing) event email settings, nested inside EventEmailSettingsContextResponse. Does not repeat the context-level ccEmail/logoUrl/logoWidth fields, which live on the parent context object.
      - `recipientPreferences` EventEmailRecipientPreferencesDto, required — Boolean flags controlling which recipient types receive event emails for a context.
        - `primaryEmail` boolean — true to send event emails to the practitioner's or facility's primary email on file; false or null to skip this recipient.
        - `caqhPrimaryEmail` boolean — true to send event emails to the CAQH-sourced primary email on file; false or null to skip this recipient.
        - `credentialingPrimaryContact` boolean — true to send event emails to the credentialing workflow's primary contact; false or null to skip this recipient.
        - `credentialingOfficeManager` boolean — true to send event emails to the office manager on the credentialing workflow; false or null to skip this recipient.
      - `typeSettings` EventEmailTypeSettingsDto[], required — One entry per configured event email type for this mode (initiated, approved, denied, cancelled, psvReady, inProgress).
        - `type` 'initiated' | 'approved' | 'denied' | 'cancelled' | 'psvReady' | 'inProgress', required — Which workflow event this entry configures: "initiated" (workflow started), "approved" (credentialing/recredentialing approved), "denied" (application denied), "cancelled" (workflow cancelled), "psvReady" (primary source verification complete), "inProgress" (workflow in progress).
        - `template` EventEmailTemplateDto, required — Subject and body content for one event email type's template.
          - `subject` string, required — Email subject line. Required and must be non-blank when the parent typeSettings entry has enabled: true.
          - `bodyHtml` string, required — Email body as HTML markup. Required and must be non-blank when the parent typeSettings entry has enabled: true.
        - `enabled` boolean, required — Whether an email is sent for this event type. When true, template.subject and template.bodyHtml must be non-blank.
    - `mmoOutcomeFilter` string[] — Primary MMO (Managed Medical Outcomes) result types to send emails for. Allowed values: "Positive" (approved plan outcomes), "Negative" (denied plan outcomes). When the workflow has both approved and denied plan UDFs for the same event, the complementary outcome email is still sent regardless of this filter (e.g. filter ["Positive"] still sends the denied-plans email if present, and vice versa) — this filter narrows the primary outcome, it does not suppress the paired one. Null or empty = no restriction (both sent).
  - `global` EventEmailGlobalSettingsResponse — Deprecated — always null. Cross-context (global) event email settings, nested under the "global" key of EventEmailSettingsConfigResponse. No endpoint writes this object and nothing consumes it, so it has been null for every organization since it was introduced. Use the practitioner and facility sub-objects instead; do not build against this one.
    - `ccEmail` string — Deprecated — always null. Would hold a CC email address applied across all contexts and modes, but no write path exists to populate it.

## Other responses

- `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/revisions/563848e0ecc0/schema)