Technical Docs
  • Introduction
  • Guides
    • Getting Started
    • Attribution Guidelines
    • Core Concepts
      • Adherence Score
      • Programs, Diets, and Rulesets
      • User Profile
      • Datasets
    • Tutorials and Walkthroughs
      • Creating a Meal Plan
      • Food Log Guide
      • Pagination
      • Executing Multiple Mutations
  • Knowledge Base
    • How-to guides
      • How to add desserts to your meal plan
      • How to log your custom recipe
      • How to generate a Meal Plan based on a template
    • Common errors
      • Meal Plan generation
    • FAQs
      • Getting Started on Suggestic
      • API and Authentication
      • Device Compatibility
      • Meal Plan
      • Nutrition
      • Programs
      • Recipes
  • HELPFUL RESOURCES
    • Deprecated Features
    • Glossary
    • Integrations
      • Building a No-code Meal Planning Application
        • Step 1: Creating the Integromat Scenario and Google Forms Connection
        • Step 2: Creating a User, Generating a Meal Plan, and Retrieving It
        • Step 3: Crafting Our PDF and Connecting PDFMonkey
        • Step 4: Sending The Document to Our User
  • Packages and SDKs
    • Node Package (NPM)
  • GraphQL
    • GraphQL Overview
    • Authentication
    • Calling GraphQL
    • GraphQL Playground
  • Changelog
    • 2025
      • March
  • Suggestic API Reference
    • Search
      • Food Log
        • Branded Foods Search
        • Common Foods Search
        • My Branded Food Search
        • My Common Foods Search
        • Food Search
        • Legacy
          • Autocomplete
          • Barcode Search
      • Recipe Search
        • Recipe Search
        • Recipe Search by Name or Ingredients
        • Recipe Search by Ingredients
      • Meal Plan Template Search
      • Profile Search
      • Restaurant Search
        • Restaurant Search by Location
        • Restaurant Search
    • Queries
      • Appointments
        • Upcoming Appointments
        • Past Appointments
        • Appointments Types
      • Assessments
        • Assessment Answers
        • Display Assessments
        • Supplement Recommendations
        • User Assessments
      • Content
        • Content Library
        • Content Categories
        • Content Tags
        • Journey
      • Food Log
        • Frequently Logged
        • Food Log Entries
        • Macros Aggregation
        • Micronutrients Aggregation
        • Macro Goals
        • Recently Logged
        • User's Foods and Recipes
          • User's Recipes
        • Legacy
          • Food Log Entries (Legacy)
          • Own Food Items
          • Own Food Item
          • Own Food Item by Id
          • Own Items
          • Own Recipe
          • Own Recipes
      • Lab Tests
        • Biomarker Categories
        • Biomarker Units
        • Biomarker Catalog
        • Biomarkers
        • Biomarker Results
        • Historical Biomarker Results
        • Historical Results by Biomarker
        • Lab Test Reports
        • Recommended Supplements
        • Recommended Articles
      • Meal Plan
        • Meal Plan
        • Custom Meal Plan
        • Simplified Meal Tracking
          • Meal Tracker
        • Meal Plan Config
        • Meal Planner (deprecated)
      • Program
        • All Programs
        • Program Details
      • Recipes
        • Equivalent Recipes (Macros)
        • Equivalent Recipes (Calories)
        • Recipe by Id
        • Recipes By MealTime
        • Recipes By Tag
        • Recipe Swap Options
        • Popular Recipes
        • Favorite Recipes
        • Premium Program Recipes
      • Restaurants
        • Restaurant By Id
        • Menu Items
        • Menu Item By Id
        • Menu Item by Program
        • Recommend Menu Items
      • Restrictions
        • Restrictions
        • Restriction by ID
      • Shopping List
        • Shopping List by Aisle
        • Shopping List by Recipes
      • Subscriptions
        • Subscription List
      • Supplement Plans
        • Supplement plan list
        • Supplement list
      • Tracking
        • Activity and Exercise
        • Checklists
          • Intake Checklist
        • Daily Recap
          • Get Daily Recap
          • Get Daily Recaps
          • Get Daily Recap Questions
          • Get Daily Mood Summary
        • Inisghts
        • Wellness Score
        • Sleep
          • Sleep Time
          • Sleep Quality Score
        • Steps
        • Water and Hydration
        • Heart Rate
        • HRV
        • Weight Tracker
      • USDA Food
      • Users
        • Users
        • User Profile
      • WGPT
        • Assistants
        • Journey
        • Guardrails
    • Mutations
      • Appointments
        • Update Appointment Credits
      • Assessments
        • New User Assessments
        • Set User Answers
      • Content
        • Mark Content as Read
      • Feedback
      • Food Log
        • Log Entries
          • Food Log
            • Add a Food Log Entry
            • Delete a Food Log Entry
          • Meal Log (Legacy)
            • Create Log Entry
            • Update Log Entry
            • Remove Log Entry
        • User's Foods and Recipes
          • Create a User Recipe
          • Create my Branded Food
          • Create my Common Foods
          • Update a User Recipe
          • Delete a User Recipe
          • Legacy: "Own" Recipe
            • Create "Own" Recipe
            • Update "Own" Recipe
            • Remove "Own" Recipe
        • AI Food Log
          • Process Ai Food
        • Legacy (ownFoods and ownRecipes)
          • Create "own" Food Item
          • Update "own Food"
          • Remove "own" Food Item
      • Journey Status
        • Start Journeys
        • Journey Status
        • Toggle Task Completed
      • Lab Tests
        • Add Biomarker
        • Update Biomarker
        • Add Biomarker Result
        • Add Biomarker Category
        • Update Biomarker Category
        • Remove Biomarker Category
        • Add Lab Test Report
        • Delete Lab Test Report
        • Update Lab Test Report
        • Create Recommended Supplement
        • Update Recommended Supplement
        • Remove Recommended Supplement
        • Create Recommended Article
        • Update Recommended Article
        • Remove Recommended Supplement
      • Meal Plan
        • Create Meal Plan Template
          • Custom Options
          • From Days
          • From Scratch
        • Assign a Meal Plan Template to a User
        • Generate Simple Meal Plan
        • Generate Meal Plan
        • Start Over Meal Plan
        • Swap Meals
        • Simplified Meal Tracking
          • Create a Meal Tracker Entry
        • Remove Meal Plan
        • Remove Meal Plan Recipe
      • Recipes
        • Add new recipe
        • Add Favorite Recipe
      • Shopping List
        • Add Multiple Recipes to the Shopping List
        • Add a Recipe to the Shopping List
        • Bulk Check/Uncheck Items
        • Check/Uncheck an Item
        • Clear Checked Items
        • Clear Shopping List
        • Remove Recipe
        • Update Serving Number
      • Subscriptions
        • Update Subscription
      • Supplement Plans
        • Create supplement plan for user
        • Update user supplement plan
        • Add Supplement
        • Update Supplement
      • Tracking
        • Activity and Exercise
          • Add Exercise Entry
          • Delete Exercise Entry
        • Checklists
          • Create my Checklist Item
          • Delete my Checklist Item
        • Daily Recap
          • Create a daily recap question
          • Select Daily Recap Questions
          • Delete a Daily Recap Question
        • Sleep
          • Add Sleep Time
          • Add Sleep Quality Score
        • Steps
          • Add Steps Count
          • Delete Steps Count
        • Heart Rate
          • Add Heart Rate
          • Delete Heart Rate
        • HRV
          • Add HRV
          • Delete HRV
        • Water and Hydration
        • Weight
          • Add Weight Entry
          • Remove Weight Entry
        • User Tracker Goals
          • Create User Goal
          • Update User Goal
          • Remove User Goal
      • Users
        • Authenticate using a Magic Link
        • Create User
        • Custom Attributes
        • Delete a User Account
        • Login User
        • Merge User Accounts
        • Request Reset Password
        • Reset Password
        • Request Password Reset email
        • Sensitive Profile Attributes
        • Update Profile
        • Update User's Program
        • User's Restrictions
        • Update Meal Plan Settings
        • User's Goals
        • Legacy User Mutations
          • Legacy | User's Biomarkers
          • User's Meal Plan Settings (deprecated)
      • WGPT
        • Add user to journey
  • Objects
    • Appointments
      • Appointment
      • Appointment Type
      • Appointment Credit
      • Attendee
      • Coach
    • Common
      • User
      • Adherence
      • Aisle Name
      • CPC
      • CPCIngredientGroup
      • Meal Times
      • Menu Item
      • Own Serving
      • Own Nutrients
      • MacroNutrientsRangeInput
      • Range
      • Tracker
      • Restaurant
    • Food Logs
      • Food Filter
      • Ingredient Amount
      • Ingredients
      • Own Recipe Ingredient
      • Meal Type
      • Nutrients
        • Nutrient Enum
      • Portions
      • Servings
      • AI Food Log
        • Food Analysis
    • Meal Plan
      • Debug Meal Plan Conditions
      • Meal
      • Meal Plan Day
      • Maximum Time per Meal
      • Maximum Ingredient Count
      • Meal Plan Template
      • Simple Meal Plan Filters
    • Recipe
      • Recipe
        • Tags
        • Cuisines
      • Recipe Swap Options
      • Parsed Ingredient Lines
      • Nutritional Info
      • Nutrients Per Serving
      • Calories Per Serving
      • Relative Calories
      • Source
      • Ingredients
      • Units of Measurement
    • Lab Tests
      • Article
      • Biomarker
    • Supplement
    • Assessments
      • Question
      • Answer
    • Content
      • Content Library
      • Content Categories
      • Content Tag
    • WGPT
      • Journey
      • dayJourney
      • Interaction
  • Case Studies
    • Reverse Health Case Study
Powered by GitBook
On this page
  • Which Meal Plan should I need to use?
  • I have an error generating the meal plan, what can I do?
  • What is the difference between recipe.numberOfServings with meal.numOfServings?
  • How can I generate a meal plan for more than 7 days?
  • Is it possible to restrict food in a meal plan?
  • How can I generate a meal plan based on a selected program? i.e Vegan or Keto
  • How can I get suggestions as to whether the food choice fits my meal plan?
  • How can I log food nutrient information for a specific food?
  • Are there any queries to get dessert recipes?

Was this helpful?

  1. Knowledge Base
  2. FAQs

Meal Plan

PreviousDevice CompatibilityNextNutrition

Last updated 2 years ago

Was this helpful?

Which Meal Plan should I need to use?

Suggestic offers 3 different meal plan types to meet your needs. The meal plan you choose will give you the best dietary program according to your food preferences and goals.

Below find the characteristics of each meal plan for you to choose the one that fits your requirements.

OPTION 1:

If you want to find a configuration that works best for your app and use cases without creating a meal plan, then the Custom Meal Plan fits for you.

OPTION 2:

If you want to create a 7-day meal plan with the possibility to add more days, use a custom format, and define a meal plan with specific settings such as mealtime preparation, meal distribution, number of ingredients, among others, then the Meal Plan fits for you.

OPTION 3:

If you want to create a 7-day meal plan without adding any arguments, create custom attributes, update meal plan settings, among others, then the Simple Meal Plan fits for you.

OPTION 4:

If you want to have control over your custom dietary requirements, you can choose one of the following meal plan templates option:

  • From days: Copy an existing meal plan which has a user assigned. All the restrictions, attributes, program assigned will be also applied to the template. For instance, a user can copy only a specific number of days from the meal plan.

  • From scratch: Create a meal plan manually. The user can define the number of days, recipes, and number of servings. For instance, it is possible to create either a 7-day meal plan or a 2-day meal plan.

  • Custom options: Create a meal plan in the same wah as if a customMealPlan is created. Therefore, calories, protein percentage, and the program to be assigned can be defined. .

The above options and their characteristics are well detailed in the following table. Choose the one that fits your requirements.

GENERAL SETTINGS

Characteristics
Simple Meal Plan
Meal Plan
Custom Meal Plan
Meal Plan Template - From Days
Meal Plan Template - From Scratch
Meal Plan Template - Custom

Create a 7-day meal plan

Request a Meal Plan to help find your ideal configuration

Define a specific number of meal plan days

Consider the user's goals

Overwrite pending days in your meal plan

Custom format such as [BREAKFAST, SNACK, LUNCH, SNACK, DINNER, SNACK]

Remove a meal plan

Assign a user to a meal plan

Create a meal plan without any argument

Prevent user from generating a new meal plan

Update meal plan settings

Setup user's food restrictions

OTHER SETTINGS

Characteristics
Simple Meal Plan
Meal Plan
Custom Meal Plan
Meal Plan Template - From days
Meal Plan Template - From Scratch
Meal Plan Template - Custom

Include 2 random recipes

Sets an upper kcal limit per meal

Define a maximum number of servings per meal

Define a maximum serving weight

Define Minimum serving weight

Define meals distribution

Define maximum quantity of ingredients per meal

Define time preparation per meal

Set the user program

Create custom attributes

Define a margin of error

Define the percentage of omega-3

Define the percent of Fat

Define the percent of Protein

Define the percent of Carbs

Define the total calories per day

Define filters to create a meal pan with caloric range and tags per each meal time

Generate a meal plan based on a meal plan template ID

Add days from the meal plan template to your current meal plan

Define the variety of the recipes

I have an error generating the meal plan, what can I do?

There are many factors to consider when creating and generating a meal plan. If the settings, restrictions, macro goals, or any other meal plan setting is not well defined, the following error may appear: Couldn't generate a meal plan with the current settings.

What is the difference between recipe.numberOfServings with meal.numOfServings?

  • meal.numOfServings is the assigned number of servings by the meal plan.

  • recipe.numberOfServings is the original recipe number of servings.

How can I generate a meal plan for more than 7 days?

Is it possible to restrict food in a meal plan?

How can I generate a meal plan based on a selected program? i.e Vegan or Keto

Execute the following API methods in the order detailed below:

How can I get suggestions as to whether the food choice fits my meal plan?

How can I log food nutrient information for a specific food?

Are there any queries to get dessert recipes?

Refer to to see how are the common scenarios in which this error appears and how to solve it.

For more information, check the

The query usually generates a 7-day meal plan. When these 7 days are reached, there are two options:

Generate a new set of 7 days using generateMealPlan with (the new day 1 will come after the "current" day 7)

Repeat the previous 7 days using generateMealPlan with (same behavior but with the same meals as before)

Yes, you can get the list of food , and then use the mutation to update a user's food restrictions.

Use the to check for available programs, copy the ID of the desired program you want to use in your meal plan.

Set the user program by executing the

Generate your meal plan, you can use either the or the

You can use the which represents how good of a match (higher is better) is a particular food recommendation with the user's and .

You can log the nutrients for a specific food by using the mutation and within it the parameter.

Yes, you can execute the , or

Custom Meal Plan
Meal Plan
Simple Meal Plan
Meal Plan Templates
this documentation
Meal Plan documentation
mealPlan
restrictions
profileRestrictionsUpdate
program query
updateUserProgram mutation
generateMealPlan mutation
customMealPlan mutation
Adherence Score
program
profile
createMealLog
MealType
recipeSearch
recipesByTag
recipesByMealTime
addDays: true
repeat: "date"