Admin Outreach Fire Batch

Persona-aware cold-outreach blast for the 152-publisher campaign.

Selection (2026-05-16 additive): * publisher_ids - exact Publisher.id UUID list (legacy). * publisher_slugs - Publisher.tenant_slug list; resolved to ids server-side, unknown slugs surfaced in skipped. * If BOTH are provided, the resolved set is the UNION (deduped). * If NEITHER is provided, falls back to the default cohort: contact_email IS NOT NULL AND cold_outreach_message_id IS NULL, ordered by tier_band DESC then created_at DESC, limited by batch_size.

Safety: * is_book_author=True publishers are HARD-SKIPPED at the send layer unless the operator explicitly passes allow_book_authors=True. This is independent of the upstream book_filter narration gate (belt-and-suspenders).

Returns {dry_run, selected, sent, failed, monday_flipped, message_ids, errors, skipped}.

post/v1/admin/outreach/fire-batch

Request

  • Base URL: https://api.storyflo.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.storyflo.com/v1/admin/outreach/fire-batch
  • Auth: none declared

Headers

x-storyflo-email-tokenstring nullable

Request body

batch_sizeinteger
personastring
dry_runboolean
publisher_idsstring[] nullable
publisher_slugsstring[] nullable
allow_book_authorsboolean
subject_variantinteger nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.