Publisher Subscribers Import

Import an existing audience into the email relay.

Accepts a pasted CSV export (csv) or a structured emails list. Every valid, deduped, not-already-present email becomes an ACTIVE free-tier PublisherSubscription so the relay starts delivering narrated stories to that reader. Idempotent — re-importing the same list only counts the already-present rows; existing paid rows are never downgraded. Publisher-token auth.

post/v1/publisher/{tenant_slug}/subscribers/import

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/publisher/{tenant_slug}/subscribers/import
  • Auth: none declared

Path parameters

tenant_slugstring required

Headers

x-storyflo-publisher-tokenstring nullable

Request body

csvstring nullable
emailsstring[] nullable
sourcestring

Response

Successful Response

okboolean required
importedinteger required
already_presentinteger required
invalidinteger required
total_parsedinteger required
active_subscribersinteger required

Changes

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