---
title: "Adding Properties"
method: POST
path: "/v1/projects/{projectId}/datasets/{name}/properties"
tags: ["Dataset Management"]
---

# Adding Properties

`POST /v1/projects/{projectId}/datasets/{name}/properties`

Creates a new Property with a specified name in the Dataset.

The name of a Property is case-sensitive in that it will keep the capitalization provided (e.g. "Firstname"). But Central will not allow another Property with the same name but different capitalization to be created (e.g. "FIRSTNAME" when "Firstname" already exists).

Property names follow the same rules as form field names (valid XML identifiers) and cannot use the reserved names of `name` or `label`, or begin with the reserved prefix `__`.

## Path parameters

- `projectId` number, required
- `name` string, required

## Response `200`

OK

- Success
  - `success` boolean, required

## Changes

- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Adding Properties` removed and replaced with `addProperties`
- **2025-10-27** `b11b54eea487` — 1 info
  - removed the non-success response with the status `403`
- **2025-10-10** `196d7d957d94` — 1 info
  - endpoint added
- **2025-03-13** `e8c2858fd4eb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/datasets/:name/properties/post.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)