# Create a variant option

URL: /en/docs/api/v1/variants/id/options/post
Last Updated: 2026-07-30T21:15:30.713Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/variants/{id}/options

**Create a variant option**

Create a new option under the given variant.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes |  |

**Request body** (`application/json`) - required:

- `title` (string, required)
- `slug` (string, required)
- `enabled` (boolean)
- `order` (integer): Lower numbers are displayed first; auto-assigned to the end of the list when omitted.
- `translations` (array of VariantTranslationInput (object))
  - `languages_code` (enum: en-US | de-DE | fr-FR, required)
  - `title` (string, required)

Example (Option with localized titles):

```json
{
  "title": "FinTech",
  "slug": "fintech",
  "enabled": true,
  "translations": [
    {
      "languages_code": "en-US",
      "title": "FinTech"
    },
    {
      "languages_code": "de-DE",
      "title": "FinTech"
    }
  ]
}
```

**Responses:**

- `201` - Variant option created
  - `success` (boolean)
  - `data` (object)
    - `option` (VariantOption (object))
      - `id` (string)
      - `title` (string)
      - `slug` (string)
      - `enabled` (boolean)
      - `order` (integer)
      - `translations` (array of VariantTranslation (object))
        - `id` (string)
        - `languages_code` (enum: en-US | de-DE | fr-FR)
        - `title` (string)
- `400` - Bad Request - validation failed
  - `error` (string): Validation error message
- `401` - Unauthorized
- `404` - Variant not found
- `409` - Conflict - slug already exists within the variant
  - `error` (string)
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/variants/var-123/options" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "FinTech",
    "slug": "fintech",
    "translations": [
      { "languages_code": "en-US", "title": "FinTech" }
    ]
  }'

```