streams

Create a stream (optionally with its first schema version and sources)

A Stream collects Submissions from many Forms into one shared shape. Pass schema to define that shape up front, or omit it and pass sources — the first source's form then provides version 1 (copied from its published schema, its inferred draft, or the fields seen in recent submissions) with an identity mapping, so { name, sources: [{ form_id }] } is a complete request.

post/v1/streams

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/streams
  • Auth: HTTP bearer

Request body

namestring
slugstring
if_exists'error' | 'return'

Response

created

idstring required
slugstring required
namestring required
current_schema_versioninteger nullable required
created_atstring required

Example response

{
  "id": "fm_8f3kq2",
  "created_at": "2026-08-21T09:00:00.000Z"
}

Changes

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