---
title: "Invite or remind selected members"
method: POST
path: "/v1/members/outreach"
tags: ["members"]
---

# Invite or remind selected members

`POST /v1/members/outreach`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/members/outreach`
- Auth: HTTP bearer

Invite or remind each selected member through their eligible delivery lane.

## Headers

- `X-Tenant-Id` string, nullable

## Request body

- MemberOutreachRequest: The exact memberships selected for bulk outreach.
  - `membership_ids` string[], required

## Response `200`

Successful Response

- MemberOutreachResponse: Ordered bulk outreach outcomes and their counts.
  - `requested` integer, required
  - `invited` integer, required
  - `reminded` integer, required
  - `skipped` integer, required
  - `results` MemberOutreachResultItem[], required
    - `membership_id` string, uuid, required
    - `outcome` 'invited_dm' | 'invited_email' | 'reminded_email' | 'skipped_activated' | 'skipped_rate_limited' | 'skipped_no_second_hello' | 'skipped_unknown_history' | 'skipped_already_queued' | 'skipped_guest' | 'skipped_guest_unverified' | 'skipped_no_channel' | 'skipped_attempts_exhausted' | 'skipped_deactivated' | 'skipped_email_suppressed' | 'skipped_owner_role' | 'failed', required: The result of one requested member outreach action.
    - `channel` 'slack_dm' | 'teams_dm' | 'email', required: The delivery lane selected for one member.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)