---
title: "Bulk Upsert Properties"
method: PUT
path: "/{organization_id}/properties/_upsert"
---

# Bulk Upsert Properties

`PUT /{organization_id}/properties/_upsert`

## Request

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

## Path parameters

- `organization_id` string, required

## Request body

- object
  - `salsify:id` string: 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.
  - `salsify:system_metadata` string: Include values for any system metadata you want to set for the property. See Properties Overview for full list.
  - `salsify:custom_metadata` string: Set any custom metadata you want to include with the property.

## Response `200`

200

- unknown[]
  - unknown

## Other responses

- `400`: 400
- `422`: 422

---

[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)