Create A Recipe

This API available only for user access-token integration

POST	/v1/recipes

Endpoint allows building recipe from scratch.

Request parameters

ATTRIBUTE	TYPE	DESCRIPTION
fields	array [string]	Extra fields to return on the recipe Possible values: normalizedIngredients, instructions, nutrition.

Request Body

ATTRIBUTE	TYPE	DESCRIPTION
collectionIds	array [string]	collection identifiers recipe should be added to
payload*	RecipePayload	recipe content

Recipe Payload

ATTRIBUTE	TYPE	DESCRIPTION
name*	string	recipe name
description	string	recipe description
ingredients	array [RawIngredient]	recipe ingredients
images	array [OriginalImage]	recipe images
instructions	RecipeInstructions	recipe instruction steps
durations	RecipeDurations	recipe cooking timing
source	ManualRecipeSource	source of the recipe, e.g. web site
servings	number	number of servings

Response

ATTRIBUTE	TYPE	DESCRIPTION
recipe*	ManualRecipeDetails	Recipe details.

RawIngredient

ATTRIBUTE	TYPE	DESCRIPTION
text*	string
group	string

NormalizedIngredient

ATTRIBUTE	TYPE	DESCRIPTION
text*	string
group	string
analysis	RecipeIngredientAnalysis

RecipeIngredientAnalysis

RecipeInstruction

RecipeInstructions

ProductCategory

ImageContainer

ResponsiveImage

OriginalImage

RecipeSource

RecipeLabels

RecipeLabel

Some RecipeLabel description

RecipeDurations

RecipeConstraints

ConstraintsCollection

RecipeSaved

RecipeAuthor

Sample Request

curl -X POST "https://graph.whisk.com/v1/recipes" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Token Access-Token>" \
  -d '{
    "collectionIds": [
      "97f77cceca5d11e7ae7e42010a9a0035"
    ],
    "payload": {
      "name": "Home made pasta",
      "description": "Pasta with tomato souce",
      "ingredients": [
        {
          "text": "Pappardelle pasta"
        },
        {
          "text": "5 tomatoes"
        },
        {
          "text": "3tbs of olive oil"
        }
      ]
    }
  }'

Sample Response

{
  "recipe": {
    "id": "1070c26c320ce194efca97093e72517b4e7",
    "name": "Home made pasta",
    "description": "Pasta with tomato sauce",
    "ingredients": [
      {
        "text": "Pappardelle pasta"
      },
      {
        "text": "5 tomatoes"
      },
      {
        "text": "3tbs of olive oil"
      }
    ],
    "saved": {
      "value": true,
      "collectionIds": [
        "cd037513c9e149a1b707e85eab1fc7f6"
      ],
      "owner": true,
      "type": "manual"
    }
  },
  "status": "success"
}