---
title: "Creates a new preference or a new preference category."
method: POST
path: "/v2/preferences"
tags: ["ApiPreference"]
---

# Creates a new preference or a new preference category.

`POST /v2/preferences`

## Request body

- ApiPreference
  - `id` integer
  - `publicName` string, nullable
  - `privateName` string, nullable
  - `isPreference` boolean
  - `order` string, nullable
  - `isPublic` boolean
  - `categoryId` integer
  - `preferenceCount` integer
  - `created` string, date-time
  - `lastModified` string, date-time
  - `isOptedIn` boolean, nullable
  - `preferences` ApiPreference[], nullable

## Response `200`

---

[API](https://skmtc.net/dotdigital/apis/apiconnector-com.md) · [All operations](https://skmtc.net/dotdigital/apis/apiconnector-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotdigital/apiconnector-com/revisions/109c0537cf77/schema)