# Brandfolder Custom Fields API

**Canonical:** https://apis.io/apis/brandfolder/brandfolder-custom-fields-api/  
**Provider:** Brandfolder — https://apis.io/providers/brandfolder/  
**Base URL:** https://brandfolder.com/api/v4  
**Documentation:** https://developers.smartsheet.com/api/brandfolder

Brandfolder Custom Fields API is one of 13 APIs that [Brandfolder](https://apis.io/providers/brandfolder/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Custom Fields. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Custom Fields can be assigned to Assets and are generally helpful for organizing and searching Assets within a Brandfolder, as well as for understanding more details about each Asset. Each Custom Field is essentially a key/value pair associated with **exactly one Asset**. Keys and values are always a string type, so use `"123"` instead of `123`. For example, if you have several Assets that represent products you sell in different colors, you might create a Custom Field for each of those Assets with a key of `"color"` and a value of `"blue"` or `"red"`, etc. If you modify or delete a `"color":"blue"` Custom Field for any particular Asset, it will not affect other Custom Fields on other Assets, even if they have the same key and/or value. > **IMPORTANT:** Think carefully about whether Tags or Custom Fields are better suited to meet the needs of your particular use case.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/brandfolders/{brandfolder_id}/custom_field_keys` | List custom field keys |
| POST | `/brandfolders/{brandfolder_id}/custom_field_keys` | Create custom field keys |
| GET | `/assets/{asset_id}/custom_field_values` | List custom fields |
| POST | `/custom_field_keys/{custom_field_key_id}/custom_field_values` | Create custom field values for an asset |
| PUT | `/custom_field_keys/{custom_field_key_id}` | Update a custom field key |
| DELETE | `/custom_field_keys/{custom_field_key_id}` | Delete a custom field key |
| PUT | `/custom_field_values/{custom_field_value_id}` | Update a custom field |
| DELETE | `/custom_field_values/{custom_field_value_id}` | Delete a custom field |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/openapi/brandfolder-custom-fields-api-openapi.yml
- **Documentation** — https://developers.smartsheet.com/api/brandfolder
- **APIReference** — https://developers.smartsheet.com/api/brandfolder/openapi
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/asyncapi/brandfolder-webhooks.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/mcp/brandfolder-tool-crosswalk.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/errors/brandfolder-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/brandfolder/refs/heads/main/data-model/brandfolder-data-model.yml

## Other Brandfolder APIs (12)

- [Brandfolder Assets API](https://apis.io/apis/brandfolder/brandfolder-assets-api/)
- [Brandfolder Attachments API](https://apis.io/apis/brandfolder/brandfolder-attachments-api/)
- [Brandfolder Binary Upload API](https://apis.io/apis/brandfolder/brandfolder-binary-upload-api/)
- [Brandfolder Brandfolders API](https://apis.io/apis/brandfolder/brandfolder-brandfolders-api/)
- [Brandfolder Collections API](https://apis.io/apis/brandfolder/brandfolder-collections-api/)
- [Brandfolder Invitations API](https://apis.io/apis/brandfolder/brandfolder-invitations-api/)
- [Brandfolder Labels API](https://apis.io/apis/brandfolder/brandfolder-labels-api/)
- [Brandfolder Organizations API](https://apis.io/apis/brandfolder/brandfolder-organizations-api/)
- [Brandfolder Sections API](https://apis.io/apis/brandfolder/brandfolder-sections-api/)
- [Brandfolder Tags API](https://apis.io/apis/brandfolder/brandfolder-tags-api/)
- [Brandfolder User Permissions API](https://apis.io/apis/brandfolder/brandfolder-user-permissions-api/)
- [Brandfolder Webhooks API](https://apis.io/apis/brandfolder/brandfolder-webhooks-api/)

## Tags

Custom Fields

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brandfolder/brandfolder-custom-fields-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brandfolder/.