---
title: "Create a favorite in a property for the user that is authorized"
method: POST
path: "/datainsights/v1.1/favorites"
tags: ["Favorites"]
---

# Create a favorite in a property for the user that is authorized

`POST /datainsights/v1.1/favorites`

A favorite gives the ability to quick search their most wanted reports

**Notes**
- There is not possible to have 2 ranks with the same value could not be duplicated.
- The maximum numbers of reports to favorite is 12.
- If a report is favorited in the rank 1 and there is already one report favorited in
the rank 1, the latest one will be put in the desired and position and all the rest of
the elements will be move one position

## Headers

- `X-PROPERTY-ID` integer, required

## Request body

- Favorite
  - `id` integer, required — Favorite Id
  - `rank` integer, required — Rank associated to the favorite in order to display the reports
  - `report_id` integer — Report, Stock Report or Hub Id favorited
  - `entity_id` integer — Report, Stock Report or Hub Id favorited
  - `report_kind` 'report' | 'stock_report' | 'hub' — Report Kind
  - `kind` 'report' | 'stock_report' | 'hub' — Favorite Kind

## Response `201`

Created

- Favorite
  - `id` integer, required — Favorite Id
  - `rank` integer, required — Rank associated to the favorite in order to display the reports
  - `report_id` integer — Report, Stock Report or Hub Id favorited
  - `entity_id` integer — Report, Stock Report or Hub Id favorited
  - `report_kind` 'report' | 'stock_report' | 'hub' — Report Kind
  - `kind` 'report' | 'stock_report' | 'hub' — Favorite Kind

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)