---
title: "List all outreach settings for an organization"
method: GET
path: "/organizations/{organizationId}/outreach-settings"
tags: ["Organization Outreach Settings Resource"]
---

# List all outreach settings for an organization

`GET /organizations/{organizationId}/outreach-settings`

Returns every outreach settings record configured for the organization, one entry per outreach type that has been saved, grouped by type. Use this when the full configuration across all three outreach types (`PRACTITIONER_CREDENTIALING`, `FACILITY_CREDENTIALING`, `PRACTITIONER_MONITORING`) is needed in a single call; use `GET /organizations/{organizationId}/outreach-settings/{type}` instead when only one type is needed. Requires the `TENANT_SETTINGS_OUTREACH_READ` permission.

## Path parameters

- `organizationId` string, required

## Headers

- `tenant-id` string, required

## Response `200`

The organization's configured outreach settings, one OutreachSettingsResponse per outreach type that has been saved (type, credentialing cycle, email recipient preferences, template, outreach reasons, and smart-outreach settings). Returns an empty array - not 404 - when the organization has not saved any outreach settings yet.

- OutreachSettingsResponse[]
  - `type` 'PRACTITIONER_CREDENTIALING' | 'FACILITY_CREDENTIALING' | 'PRACTITIONER_MONITORING' — The outreach configuration category a settings record applies to. PRACTITIONER_CREDENTIALING covers outreach for individual practitioners going through initial or recredentialing review. FACILITY_CREDENTIALING covers the same for facilities. PRACTITIONER_MONITORING covers ongoing monitoring-triggered outreach for practitioners, outside the credentialing review cycle.
  - `credentialingCycle` 'INITIAL' | 'RECREDENTIALING' — Credentialing cycle for which these template/reasons apply
  - `emailRecipientPreferences` object, nullable — Email recipient preferences for outreach
    - `primaryEmail` boolean — Enable Primary Email recipient
    - `caqhPrimaryEmail` boolean — Enable CAQH Primary Email recipient
    - `credentialingPrimaryContact` boolean — Enable Credentialing Primary Contact recipient
    - `credentialingOfficeManager` boolean — Enable Credentialing Office Manager recipient
  - `template` object, nullable — Email template configuration for outreach
    - `ccEmails` string[] — Template-specific CC email addresses
    - `subject` string, required — Email subject line with placeholders
    - `body` string, required — Email body content with placeholders (supports HTML/rich text)
    - `logo` OutreachLogoDto — Logo settings for outreach email template
      - `enabled` boolean — Whether to include the logo in emails
      - `url` string — Logo URL/address
      - `width` string — Logo display width
  - `outreachReasons` OutreachReasonDto[], nullable — List of outreach reasons with instructions. Null when nothing has been saved for this type/cycle.
    - `id` string — Unique identifier for the outreach reason
    - `reason` string, required — Reason title
    - `instruction` string, required — Instruction text
    - `isCaqhResolvable` boolean — Whether the reason is resolvable directly in CAQH (external action, no upload)
    - `submitFormText` string — Text shown to the provider on the submit form for this reason
  - `smartOutreach` object, nullable — Smart outreach automation settings
    - `enabled` boolean — Enable smart outreach automation
    - `businessDaysBetweenAttempts` integer — Business days between outreach attempts (display value, persisted as hours)
    - `maxAttemptsPerReason` integer — Maximum outreach attempts per reason
    - `recredCadenceDays` integer, nullable — Recredentialing cadence in days (null disables recred override)
    - `dryRunEnabled` boolean — Dry run mode: evaluate exclusions without sending (per client)
    - `useCalendarDays` boolean — Count days between attempts on calendar days (weekends/holidays included) instead of business days. Defaults to false (business days).
    - `caqhValidStatuses` string[], nullable — CAQH provider_status values that qualify as a valid update and suppress outreach. Defaults to ["Reattestation", "Initial Application Complete"] when null or empty.
  - `providerPortalEnabled` boolean, nullable — Whether the provider outreach portal is enabled for this organization. Organization-wide (not per type/cycle); null when the organization has never saved the setting, which consumers must treat as disabled.

## Other responses

- `400` — The tenant-id header is missing or blank.
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — Organization not found
- `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)