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

ATTRIBUTE

TYPE

DESCRIPTION

product*

string

​

canonicalName*

string

​

quantity

number

​

unit

string

​

multiplier

number

​

brand

string

​

comment

string

​

category

string

​

RecipeInstruction

ATTRIBUTE

TYPE

DESCRIPTION

text*

string

​

group

string

​

images

array [ImageContainer]

​

RecipeInstructions

ATTRIBUTE

TYPE

DESCRIPTION

steps*

array [RecipeInstruction]

​

ProductCategory

ATTRIBUTE

TYPE

DESCRIPTION

name*

string

​

ImageContainer

ATTRIBUTE

TYPE

DESCRIPTION

url*

string

original image url, depricated. Please use field original instead

original

OriginalImage

original image information, e.g. image url

responsive*

ResponsiveImage

​

ResponsiveImage

ATTRIBUTE

TYPE

DESCRIPTION

url*

string

Hosted url of an image

width*

integer

Image width

height*

integer

Image height

OriginalImage

ATTRIBUTE

TYPE

DESCRIPTION

url*

string

URL of the image

RecipeSource

ATTRIBUTE

TYPE

DESCRIPTION

name*

string

​

displayName

string

​

sourceRecipeUrl

string

​

license

string

​

image

ImageContainer

​

RecipeLabels

ATTRIBUTE

TYPE

DESCRIPTION

mealType*

array [RecipeLabel]

​

cuisine*

array [RecipeLabel]

​

category*

array [RecipeLabel]

​

RecipeLabel

Some RecipeLabel description

ATTRIBUTE

TYPE

DESCRIPTION

name*

string

​

displayName*

string

​

RecipeDurations

ATTRIBUTE

TYPE

DESCRIPTION

cookTime

number

Cooking time in minutes

prepTime

number

Preparation time in minutes

totalTime

number

Total time in minutes

RecipeConstraints

ATTRIBUTE

TYPE

DESCRIPTION

violates*

ConstraintsCollection

Constraints which are violated in a recipe

ConstraintsCollection

ATTRIBUTE

TYPE

DESCRIPTION

diets*

array

List of diets Possible values: lacto-vegetarian, ovo-vegetarian, ovo-lacto-vegetarian, pescatarian, vegan, vegetarian.

avoidances*

array

List of avoidances and intolerances Possible values: celery, crustacean, egg, fish, groundnut, milk, mollusc, mustard, sesame, soybean, sulphites, tree-nut, wheat.

RecipeSaved

ATTRIBUTE

TYPE

DESCRIPTION

value

boolean

True if this recipe is saved to favorites

collectionIds

array [string]

​

owner

boolean

If the current user is the owner of the recipe

type

enum

Recipe type Possible values: manual, imported.

RecipeAuthor

ATTRIBUTE

TYPE

DESCRIPTION

name*

string

​

image

ImageContainer

​

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"
}