# Create Favorite Creates a new favorite filter set for a user on a given tab. Endpoint: POST /api/v3/favorites Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `tab` (string, required) Example: "Invoices" - `favorite` (object, required) - `favorite.name` (string) Example: "fav1" - `favorite.filters` (object) Opaque client-side state. The API stores the object as sent and returns it unchanged; it does not validate or interpret any key. The keys below are the ones the web app uses. - `favorite.filters.page` (integer) Example: 1 - `favorite.filters.itemsPerPage` (string) Example: "10" - `favorite.filters.showTotalWithIVA` (boolean) - `favorite.filters.text` (string) - `favorite.filters.type` (object) - `favorite.filters.type.invoice` (boolean) Example: true - `favorite.filters.type.invoiceReceipt` (boolean) Example: true - `favorite.filters.type.simplifiedInvoice` (boolean) Example: true - `favorite.filters.type.cashInvoice` (boolean) Example: true - `favorite.filters.type.debitNote` (boolean) Example: true - `favorite.filters.type.vatMossInvoice` (boolean) Example: true - `favorite.filters.type.creditNote` (boolean) Example: true - `favorite.filters.type.vatMossCreditNote` (boolean) Example: true - `favorite.filters.type.receipt` (boolean) Example: true - `favorite.filters.type.vatMossReceipt` (boolean) Example: true - `favorite.filters.status` (object) - `favorite.filters.status.draft` (boolean) Example: true - `favorite.filters.status.sent` (boolean) Example: true - `favorite.filters.status.settled` (boolean) Example: true - `favorite.filters.status.canceled` (boolean) Example: true - `favorite.filters.status.second_copy` (boolean) Example: true - `favorite.filters.archived` (boolean) - `favorite.filters.nonArchived` (boolean) Example: true - `favorite.filters.documentTotalRange` (object) - `favorite.filters.documentTotalRange.from` (string,null) - `favorite.filters.documentTotalRange.to` (string,null) - `favorite.filters.sort` (string) Example: "document_date" - `favorite.filters.sortOrder` (string) Example: "desc" - `favorite.filters.series` (array) Example: [] - `favorite.filters.plugins` (array) Example: [] - `favorite.filters.clientList` (array) Example: [] - `favorite.filters.batchId` (string) - `favorite.filters.registration` (object) - `favorite.filters.registration.registered` (boolean) Example: true - `favorite.filters.registration.notRegistered` (boolean) Example: true - `favorite.filters.registration.partiallyRegistered` (boolean) Example: true - `favorite.filters.issueDate` (object) - `favorite.filters.issueDateLabel` (string) - `favorite.filters.dueDate` (object) - `favorite.filters.dueDateLabel` (string) ## Response 201 fields (application/json): - `favorite` (object) - `favorite.uid` (string) Example: "bddeb153-0e80-4238-846f-546c0327f451" ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)