---
title: "Generates and returns a list of suggested favorites."
method: POST
path: "/me/favorites/suggestions"
tags: ["favorites"]
---

# Generates and returns a list of suggested favorites.

`POST /me/favorites/suggestions`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/me/favorites/suggestions`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/me/favorites/suggestions/post.ts> (a function with typed inputs; its response is checked against the schema)

It will create 3 favorites based on past user's TE activity and return them. Suggested favorites will be created only once for a given user, and only if the user has never created a favorite before (either manually or by a previous suggestion request). If there is no past TE data there won't be suggested favorites either.

## Response `201`

List of suggested favorites

- ModelsFavorite[]
  - `billable` boolean
  - `client_name` string: Related entities meta fields - if requested
  - `created_at` string
  - `deleted_at` string
  - `description` string
  - `favorite_id` integer
  - `project_active` boolean
  - `project_color` string
  - `project_id` integer
  - `project_name` string
  - `public` boolean
  - `rank` integer
  - `tag_ids` integer[]: tag IDs are loaded into this after loading the Favorite
  - `task_id` integer
  - `task_name` string
  - `workspace_id` integer

## Other responses

- `204`: No suggested favorites
- `403`: User {user_id} has no access to Favorites feature
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)