---
title: "Create option"
method: POST
path: "/api/1/taxonomy/metaproperties/{metapropertyId}/options"
tags: ["Options - New API (Preferred)"]
---

# Create option

`POST /api/1/taxonomy/metaproperties/{metapropertyId}/options`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/1/taxonomy/metaproperties/{metapropertyId}/options`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `METAPROPERTYMANAGEMENT`, `METAMANAGEMENT`
  - API key in header `Authorization`

Create a new option

## Path parameters

- `metapropertyId` string, uuid, required

## Request body

- object
  - `definition` string
  - `externalReference` string
  - `icon` string
  - `name` string, required

## Response `200`

- object
  - `definition` string
  - `icon` string, required
  - `id` string, uuid, required
  - `name` string, required
  - `status` string, required

## Other responses

- `201`
- `400`
- `404`

---

[API](https://skmtc.dev/bynder/apis/metaproperty-options.md) - [All operations](https://skmtc.dev/bynder/apis/metaproperty-options/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/metaproperty-options/revisions/cb25c26e004e?raw)