---
title: "Add values to an attribute"
method: POST
path: "/attributes/{companyId}/{customId}/values/bulk"
tags: ["Attributes"]
---

# Add values to an attribute

`POST /attributes/{companyId}/{customId}/values/bulk`

Adds values to an existing attribute, identified by `customId`, without affecting its other values. If a value with the same `customId` already exists on the attribute, it is replaced. This endpoint does not verify that the attribute exists beforehand.

## Path parameters

- `customId` string, required
- `companyId` string, required

## Request body

- BulkPostAttributesValuesRequestSchema
  - `data` AttributesRequestValuesSchema[], required — Values to add to the attribute.
    - `customId` string, required — Your own unique ID for the value, unique within the attribute.
    - `name` string, required — Display name of the value.
    - `parentCustomId` string, nullable — Custom ID of the value of the parent attribute (see the attribute's `parentCustomId`) that this value is nested under. Ignored if the attribute has no `parentCustomId` or no value with this `customId` exists yet on the parent attribute.

## Response `200`

Successful Response

- BulkUpsertAttributesResponseSchema
  - `data` UpsertAttributesResponseSchema[], required — Result of the bulk operation, one entry per attribute.
    - `id` string, required — Embat resource ID
    - `customId` string, required — Client-provided custom ID

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Not found. The requested resource or `companyId` does not exist.
- `422` — Validation Error
- `500` — Unexpected error. Contact support if it persists.

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/versions/36ca48bf4489/schema)