---
title: "Bulk Create New Properties"
method: POST
path: "/{org_id}/properties"
---

# Bulk Create New Properties

`POST /{org_id}/properties`

## Request

- Base URL: `https://app.salsify.com/api/v1/orgs`
- URL: `https://app.salsify.com/api/v1/orgs/{org_id}/properties`
- Auth: API key in header `Authorization`

## Path parameters

- `org_id` string, required

## Request body

- object
  - `salsify:id` string, required: Unique identifier for property. Used in report headers, channel mapping, etc. Cannot start with `salsify`, `=`, or `_`. Case sensitive.
  - `salsify:name` string: Property name, if different from ID. Best practice is for property ID and name to match. If not specified, property name will be filled with property ID value.
  - `system_metadata` string: Include values for any system metadata you want to set for the property. See Properties Overview for full list.
  - `custom_metadata` string: Set any custom metadata you want to include with the property.

## Response `200`

200

- object[]
  - `salsify:id` string
  - `salsify:name` string
  - `salsify:data_type` string
  - `salsify:entity_types` object[]
  - `salsify:is_facetable` boolean
  - `salsify:attribute_group` string
  - `salsify:position` unknown
  - `salsify:help_text` string
  - `salsify:manage_permissions` unknown
  - `salsify:read_permissions` unknown
  - `salsify:hidden_permissions` unknown
  - `salsify:created_at` string
  - `salsify:updated_at` string
  - `salsify:type` string
  - `salsify:system_id` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param.md) - [All operations](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param/llms.txt) - [OpenAPI document](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param/revisions/e45c99004f46?raw)