# Create a variant

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

## 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

**Create a variant**

Create a new variant for the tenant. Options can be created inline via the `options` array. When `order` is omitted it is auto-assigned to the end of the list.

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

**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)
- `options` (array of VariantOptionCreate (object))
  - `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 (Variant with localized options):

```json
{
  "title": "Industry",
  "slug": "industry",
  "enabled": true,
  "translations": [
    {
      "languages_code": "en-US",
      "title": "Industry"
    },
    {
      "languages_code": "de-DE",
      "title": "Branche"
    }
  ],
  "options": [
    {
      "title": "FinTech",
      "slug": "fintech",
      "translations": [
        {
          "languages_code": "en-US",
          "title": "FinTech"
        }
      ]
    },
    {
      "title": "HealthTech",
      "slug": "healthtech"
    }
  ]
}
```

**Responses:**

- `201` - Variant created
  - `success` (boolean)
  - `data` (object)
    - `variant` (Variant (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)
      - `options` (array of 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
- `409` - Conflict - slug already exists
  - `error` (string)
- `500` - Internal server error

**Code samples:**

cURL:

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

```