> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Headshot Campaigns

> Manage AI staff headshot campaigns: create campaigns, set styles and deadlines, monitor submissions, and send reminders.

Headshot Campaigns is the page at `/headshots/campaigns` where users with the `platform.headshots.manage` permission create and manage AI-generated staff headshot campaigns, set submission deadlines, and send reminder invitations.

## Overview

The page renders a `CampaignDashboard` listing all campaigns for the current organization. A **Create Campaign** action opens a `CampaignCreateForm` where the campaign name, description, headshot style, and deadline are configured. Each campaign entry supports viewing details and sending reminder invitations via the `pf-headshot-campaign-invite` Supabase Edge Function.

The parent headshots route (`/headshots`) requires `platform.headshots.generate`.

## Who it's for

Requires permission `platform.headshots.manage`.

## Before you start

* Confirm you hold `platform.headshots.manage` in your role.
* Identify the list of staff members to include in the campaign.
* Choose a headshot style appropriate for your organization's branding.

## Steps

1. Navigate to `/headshots/campaigns`.
2. Review existing campaigns in the dashboard.
3. To create a campaign, click **Create Campaign**. Enter a name, description, select a style, and set a deadline.
4. Submit the form to create the campaign.
5. To send reminder invitations to participants who have not yet submitted, use the **Send Reminder** action on a campaign.
6. To view campaign details, click into a campaign row.

## Key concepts

**Headshot style** — a `HeadshotStyle` enum value that controls the AI generation aesthetic. Specific values should be confirmed with an SME.

**Campaign invite edge function** — `pf-headshot-campaign-invite` handles sending invitation and reminder communications to staff.

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/headshot/pages/CampaignManagementPage.tsx
  * src/platform/headshot/hooks/useHeadshotCampaigns.ts
</Accordion>
