---
title: "Create option"
method: POST
path: "/api/v4/metaproperties/{id}/options"
tags: ["Options - Old API (Please use new API if possible)"]
---

# Create option

`POST /api/v4/metaproperties/{id}/options`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/v4/metaproperties/{id}/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`

Requires the METAPROPERTYMANAGEMENT or METAMANAGEMENT security role.

Note: when the `name` you provide differs from the option's label, Bynder automatically assigns that `name` value as the option's `externalReference`. Explicitly setting `externalReference` to `null` or an empty string does not prevent this. To store a specific external reference, pass the desired value in the `externalReference` field.

## Path parameters

- `id` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `data` string: JSON-serialised string

## Response `201`

Created

- object
  - `id` string
  - `message` string
  - `statuscode` integer

## Other responses

- `400`: Bad Request
- `404`: Metaproperty not found

---

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