Skip to main content
POST
Create a recipe

Authorizations

X-API-Key
string
header
required

An API key created from a signed-in session. See Authentication.

Body

application/json
name
string
required

Recipe name

Minimum string length: 1
style
string | null

Beer style, e.g. "American IPA"

type
enum<string>
default:all_grain

Brewing method

Available options:
all_grain,
extract,
partial_mash
batch_size_liters
number
default:19

Target volume in the fermenter, in litres

boil_time_minutes
integer
default:60

Boil duration in minutes

Required range: x >= 0
efficiency
number
default:0.72

Brewhouse efficiency as a decimal (0–1)

Required range: 0 <= x <= 1
notes
string | null

Freeform recipe notes

Response

The created recipe

id
string<uuid>
read-only

Unique identifier

user_id
string
read-only

Owning account

name
string

Recipe name

style
string | null

Beer style

type
enum<string>

Brewing method

Available options:
all_grain,
extract,
partial_mash
batch_size_liters
number

Target volume in the fermenter, in litres

boil_time_minutes
integer

Boil duration in minutes

efficiency
number

Brewhouse efficiency as a decimal (0–1)

notes
string | null

Freeform recipe notes

est_color_srm
number | null

Estimated colour in SRM

created_at
string<date-time>
read-only

ISO 8601 timestamp

updated_at
string<date-time>
read-only

ISO 8601 timestamp