# Create custom field values for an asset

Creates custom fields for the matching asset.

In order to use this endpoint, you will need to have the Custom Field Key ID
for the Custom Field you wish to create. Please see [List Custom Field Keys
for a
Brandfolder](/api/brandfolder/openapi/custom_fields/opidapiv4brandfolderscustomfieldkeysbybrandfolderidget)
to get a list of the Custom Field Key IDs.

Want to learn more about Custom Fields? Check out out our Knowledge Base
article on Custom
Fields.

Endpoint: POST /custom_field_keys/{custom_field_key_id}/custom_field_values
Version: v4
Security: APIToken

## Path parameters:

  - `custom_field_key_id` (string, required)
    Unique identifier for the resource instance.
    Example: "oqgkkd-fr5iv4-443db"

## Header parameters:

  - `Content-Type` (string, required)
    Enum: "application/json"

  - `Accept` (string, required)
    Enum: "application/json"

  - `Authorization` (string, required)
    Bearer token for authentication

## Request fields (application/json):

  - `data` (array, required)
    A list of custom field associations.

  - `data.attributes` (object, required)

  - `data.attributes.value` (string, required)
    Custom field key value.
    Example: "red"

  - `data.relationships` (object, required)
    Specifies the object receiving the custom field.

  - `data.relationships.asset` (object, required)

  - `data.relationships.asset.data` (object, required)

  - `data.relationships.asset.data.type` (string, required)
    The type of target object.
    Enum: "assets"

  - `data.relationships.asset.data.id` (string, required)
    The ID of the asset.
    Example: "k5nj2bf5mc36j3ssm63359h"

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)
    Unique identifier for the resource instance.
    Example: "r79p3j4gbcgtv33gbsqrxb"

  - `data.type` (string, required)
    The type of the resource.
    Enum: "custom_field_values"

  - `data.attributes` (object, required)

  - `data.attributes.key` (string)
    A key name.
    Example: "team"

  - `data.attributes.value` (string)
    The value for the key.
    Example: "product"