---
title: "Start outreach discovery"
method: POST
path: "/outreach/discoveries"
---

# Start outreach discovery

`POST /outreach/discoveries`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/outreach/discoveries`
- Auth: HTTP bearer

Starts provider-read-only candidate discovery for a server-issued tenant, workspace, agent session, principal context, provider binding, and capability receipt. Requires a signed-in BAMF user session and Idempotency-Key. Never creates or sends a campaign.

## Headers

- `Idempotency-Key` string, required

## Request body

- OutreachDiscoveryStartRequest
  - `workspace_id` string, uuid, required
  - `session_id` string, uuid, required
  - `principal_context_ref_id` string, uuid, required
  - `gateway_run_id` string, uuid, required
  - `provider` string, required
  - `provider_account_id` string, required
  - `capability_receipt_ref` string, required
  - `source_mode` 'external' | 'crm' | 'first_degree', required
  - `targeting` string, required

## Response `200`

Discovery state; providerMutation is always false

## Other responses

- `403`: Tenant, principal, capability, or session denied

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)