---
title: "Create a recipe"
method: POST
path: "/compat/v2/recipes/createRecipe"
tags: ["recipes"]
---

# Create a recipe

`POST /compat/v2/recipes/createRecipe`

## Request body

- object
  - `title` string, required
  - `description` string, required
  - `yield` string, required
  - `activeTime` string, required
  - `totalTime` string, required
  - `source` string, required
  - `url` string, required
  - `notes` string, required
  - `ingredients` string, required
  - `instructions` string, required
  - `rating` number, nullable, required
  - `folder` union, required
    - 'main'
    - 'inbox'
  - `labelIds` string[], required
  - `imageIds` string[], required
  - `lastMadeAt` string, nullable
  - `linkedRecipeIds` string[]
  - `nutritionServingSize` string, nullable
  - `nutritionCalories` number, nullable
  - `nutritionTotalFat` number, nullable
  - `nutritionSaturatedFat` number, nullable
  - `nutritionTransFat` number, nullable
  - `nutritionPolyunsaturatedFat` number, nullable
  - `nutritionMonounsaturatedFat` number, nullable
  - `nutritionCholesterol` number, nullable
  - `nutritionSodium` number, nullable
  - `nutritionTotalCarbs` number, nullable
  - `nutritionDietaryFiber` number, nullable
  - `nutritionTotalSugars` number, nullable
  - `nutritionAddedSugars` number, nullable
  - `nutritionProtein` number, nullable
  - `nutritionVitaminD` number, nullable
  - `nutritionCalcium` number, nullable
  - `nutritionIron` number, nullable
  - `nutritionPotassium` number, nullable
  - `nutritionOtherDetails` string, nullable

## Response `200`

Successful response

- object
  - `id` string, uuid, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.dev/recipesage/apis/recipesage-api.md) · [All operations](https://skmtc.dev/recipesage/apis/recipesage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recipesage/recipesage-api/revisions/08ef517bf108/schema)