---
title: "Create an extra"
method: POST
path: "/api/v1/extras"
tags: ["Extras"]
---

# Create an extra

`POST /api/v1/extras`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/extras`
- Auth: none declared. Required headers: `Api-Key`

Creates a new extra within an extra group. Extras live in groups, and groups live in extra categories. Find a category's groups with the extra groups endpoint, or create one first.

The `extra_group_id` of the parent group is required, along with a `name` and a `description`. Pricing defaults to a flat rate of 0. Set `price_method` and the matching price field to charge for it. New extras are appended to the end of the group.

**Required permission:** `offerings_write`

## Headers

- `Api-Key` string, required

## Request body

- object
  - `extra_group_id` integer, required: ID of the parent extra group this extra belongs to
  - `name` string, required: The name of the extra (e.g., "Gold Sequin Backdrop")
  - `description` string, required: Customer-facing description of the extra
  - `status` 'Active' | 'Archived': Whether the extra is active or archived
  - `price_method` 'flat_rate' | 'hourly' | 'daily': How the extra is priced
  - `price` number: Flat-rate price in dollars (used when price_method is flat_rate)
  - `hourly_price` number: Per-hour price in dollars (used when price_method is hourly)
  - `daily_price` number: Per-day price in dollars (used when price_method is daily)
  - `taxable` boolean: Whether the extra is taxable
  - `maximum_quantity` integer: Maximum quantity a customer can book (must be >= 1)
  - `multiply_by_number_of_units` boolean: Multiply the price by the quantity booked
  - `visible_on_widget` boolean: Whether the extra is shown on the booking widget
  - `adds_minutes_to_event_length` boolean: Whether booking this extra extends the event length
  - `minutes_to_be_added_to_event_length` integer: Minutes added to the event length when adds_minutes_to_event_length is true
  - `requires_lead_time` boolean: Whether the extra requires advance lead time to book
  - `lead_time_days` integer: Required lead time in days (when requires_lead_time is true)
  - `video_url` string: YouTube URL for a demo video of the extra

## Response `200`

extra created

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)