Skip to content
Skip to Content
Docs
Studio

Create Recipe

Create a new recipe in ACTIVE state. Only name is required. Country defaults to US. Demographic defaults to adults_and_children_over_4.

Recipes beyond your plan's included monthly allowance are billed at your plan's metered rate when the organization has a paid subscription; otherwise creation stops at the limit. Manage your plan and usage in BetterMenu Studio.

POST
/studio/recipes

Request Body

application/json
  1. body

Create a new recipe in ACTIVE state.

Only name is required. Country defaults to US (the only supported country today — more coming soon) and demographic defaults to adults_and_children_over_4, the general-population demographic group.

The demographic must be valid for the country's regulatory authority. US (US_FDA) supports: adults_and_children_over_4, infants_through_12_months, children_1_3_years, pregnant_and_lactating_women.

name*Name

Recipe name

Length1 <= length <= 255
country?Country

Country whose regulatory framework applies. Determines which regulatory authority and demographic groups are valid. Currently only US (→ US_FDA) is supported.

Default"US"
demographic?FDADemographic

Demographic group for %DV (percent daily value) calculations. Must be valid for the country's regulatory authority. US_FDA demographics: adults_and_children_over_4 (default), infants_through_12_months, children_1_3_years, pregnant_and_lactating_women.

Default"adults_and_children_over_4"
Value in"adults_and_children_over_4""infants_through_12_months""children_1_3_years""pregnant_and_lactating_women"

Response Body

Successful Response

application/json
  1. response

Response for get recipe endpoint.

data*

Recipe with presence summary and computed action permissions.

meta*

Response metadata.

version_id?|

Version committed for this mutation; pass on the next request as If-Match for optimistic concurrency. Present only on versions declaring the recipe_versioning capability.

Example Request
curl -X POST 'https://api.bettermenu.live/studio/recipes' \  -H 'Content-Type: application/json' \  -d '{  "name": "Chocolate Chip Cookies"}'
Example Response
{  "data": {    "id": "string",    "name": "string",    "country": "US",    "regulatory_authority": "US_FDA",    "demographic": "adults_and_children_over_4",    "status": "active",    "created_at": "string",    "updated_at": "string",    "summary": {      "ingredient_count": 0,      "has_nutrition": true,      "is_nutrition_current": true,      "serving_count": 0,      "has_nutrition_facts": true    },    "actions": {      "can_modify": true,      "can_archive": true,      "can_delete": true    }  },  "meta": {    "version": "string",    "request_id": "string",    "timestamp": "string"  },  "version_id": "string"}

Recipe in, FDA-format Nutrition Facts out, with every version kept.

Start freeNo card needed.