Create one Outreach (campaign container) in draft.
REUSE BEFORE CREATE: an Outreach is a commercial thread. Before creating one, call GET /outreach (or GET /search?type=outreach) and reuse the existing Outreach whenever it already represents the same thread — same audience, same angle, same reason. Create a new one only when no existing Outreach represents it.
This creates the CONTAINER ONLY. No targets, executions, actions, messages or sends are created implicitly. Attach targets afterwards with POST /targets using the returned id as campaignId, and record real sends with POST /outreach/{id}/executions.
The server always sets the state: outreach_status = draft, status = active, ownership = the credential's user, workspace = the credential's workspace, created_by = the credential's user. An Outreach can never be created in ready_to_send, waiting_for_responses or executed state — those are facts derived from recorded executions, not declarable at creation.
Request
- Base URL: https://forbiz.io/api/public/agent
- URL: https://forbiz.io/api/public/agent/outreach
- Auth: HTTP bearer
Headers
Recommended on every mutating request. A replay with the same key is NOT applied twice: the server answers { ok, idempotent_replay: true, first_seen_at, status } describing the first attempt.
Request body
Response
Outreach created in draft. Container only.
Changes
No recorded changes to this operation across all 1 revision of this API.