---
title: "Store a new preference for this user."
method: POST
path: "/v1/preferences"
tags: ["preferences"]
---

# Store a new preference for this user.

`POST /v1/preferences`

This endpoint creates a new preference. The name and data are free-format, and entirely up to you. If the preference is not used in Firefly III itself it may not be configurable through the user interface, but you can use this endpoint to persist custom data for your own app.

## Headers

- `X-Trace-Id` string, uuid

## Request body

- Preference
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string, string, required
  - `data` union, required
    - boolean
    - string
    - object
    - StringArrayItem[]

## Response `200`

New account stored, result in response.

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `404` — Page not found
- `422` — Validation error. The body will have the exact details.
- `500` — Internal exception

---

[API](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop.md) · [All operations](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firefly-iii/firefly-iii-api-develop/revisions/8a1f6472e04b/schema)