---
title: "Send a new credentialing outreach email"
method: POST
path: "/credentialing-outreaches"
tags: ["Credentialing Outreach Resource"]
---

# Send a new credentialing outreach email

`POST /credentialing-outreaches`

Sends a credentialing outreach email to one or more email addresses, with optional CC, BCC, reply-to, and attachments. The 'toEmails' field accepts a list of email addresses directly.

## Headers

- `tenant-id` string, required

## Request body

- SendCredentialingOutreachRequest — Request body for sending a credentialing outreach email
  - `workflowId` string — The workflow ID for the credentialing outreach. Required for single-workflow requests. When workflowIds is provided with more than one entry, this field is optional.
  - `workflowIds` string[] — List of workflow IDs for multi-tenant outreach. When more than one entry is provided, initiatingWorkflowId must also be set. Single-workflow requests should leave this null and use workflowId instead.
  - `initiatingWorkflowId` string — The workflow ID of the initiating org for multi-tenant outreach. Required when workflowIds contains more than one entry. Must be present in the workflowIds list. The initiating workflow's tenant outreach-settings template is applied to all bundled workflows.
  - `toEmails` string[], required — List of email addresses to send the outreach email to
  - `body` string, required — Email body content
  - `ccEmails` string[] — Optional list of CC email addresses
  - `bccEmails` string[] — Optional list of BCC email addresses
  - `outreachReasons` string[], required — List of reasons for the outreach
  - `subject` string, required — Email subject line
  - `attachments` AttachmentDTO[] — Optional list of email attachments
    - `filename` string, required
    - `content` string, binary, required
    - `contentType` string, required
  - `multiTenant` boolean

## Response `201`

Outreach email sent successfully. Two response shapes are possible: (1) Multi-tenant request (workflowIds.size > 1): body is MultiTenantOutreachResult with fields outreachId (String) and sends (PerWorkflowSendStatus[]). (2) Single-workflow request: body is a bare String containing the outreach record ID.

## Other responses

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

---

[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/3d27e9019c7b/schema)