Skip to main content
POST
Move favorites

Authorizations

X-API-Key
string
header
required

API key (sk_xxx) from Developer Settings. No X-Account-ID needed.

Headers

x-account-id
string | null

Body

application/json

Request to move favorites to a folder.

favorite_ids
string<uuid>[]
required

List of favorite IDs to move

folder_id
string<uuid> | null

Target folder ID (None for root)

Response

Successful Response

entity_type
string
required

Entity type: 'company', 'contact', or 'deal'

entity_id
string<uuid>
required

ID of the favorited entity

id
string<uuid>
required
account_id
string<uuid>
required
user_id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
folder_id
string<uuid> | null

Folder ID to organize favorites

display_order
integer | null

Display order

notes
string | null

Optional notes about why it's favorited

entity_name
string | null

Name of the favorited entity