# Outreach composer (/ui/candidate-outreach-composer)

## What it shows [#what-it-shows]

Drafts a first message to a person.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `channels` (required) | `readonly CandidateOutreachChannel<TValue>[]` | The channels, in order, as buttons in the header. |
| `channel` (required) | `TValue` |   |
| `onChannelChange` (required) | `(value: TValue) => void` |   |
| `guidance` (required) | `CandidateOutreachGuidance` |   |
| `draft` | `CandidateOutreachDraft \| null` | The draft for the current channel. Without one, the composer offers to write it. |
| `drafting` | `boolean` | Shows the draft's progress and disables Draft and Redo. |
| `error` | `ReactNode` | Why the last draft failed. |
| `copied` | `boolean` | Shows Copied, with a check, in place of Copy. |
| `onDraft` (required) | `() => void` | Writes a draft, or a fresh one. |
| `onCopy` (required) | `() => void` | Copies the draft; the host decides what goes on the clipboard. |
| `onEditDraft` (required) | `(message: string) => void` |   |
| `labels` | `Partial<CandidateOutreachComposerLabels>` |   |
| `border` | `"none" \| "top" \| "bottom"` | The kit PanelSection's divider. |

## Data it needs [#data-it-needs]

The component takes plain values and callbacks and keeps no records of its own. Pass it yours, from the Kith data layer or from a backend you already run.

## Copy to your agent [#copy-to-your-agent]

```text title="Copy to your agent"
Install RecruiterOS/recruit-ui and add an outreach composer that drafts a first message per channel.
```