> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Addon

Creates a new addon in draft status.

## Mutation

<CodeGroup>
  ```graphql Mutation theme={null}
  mutation CreateAddon($input: AddonCreateInput!) {
    createOneAddon(input: $input) {
      id
      refId
      displayName
      description
      status
      pricingType
      maxQuantity
      versionNumber
    }
  }
  ```

  ```json Variables theme={null}
  {
    "input": {
      "refId": "addon-extra-seats",
      "displayName": "Extra Seats",
      "description": "Add more team members",
      "productId": "product-main",
      "pricingType": "PAID",
      "maxQuantity": 100
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "createOneAddon": {
        "id": "addon-uuid-123",
        "refId": "addon-extra-seats",
        "displayName": "Extra Seats",
        "description": "Add more team members",
        "status": "DRAFT",
        "pricingType": "PAID",
        "maxQuantity": 100,
        "versionNumber": 1
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="input" type="AddonCreateInput" required>
  Input for creating an addon

  <Expandable title="properties">
    <ParamField body="productId" type="String" required>
      Product reference ID
    </ParamField>

    <ParamField body="displayName" type="String" required>
      Addon display name
    </ParamField>

    <ParamField body="refId" type="String">
      Unique addon reference ID
    </ParamField>

    <ParamField body="description" type="String">
      Addon description
    </ParamField>

    <ParamField body="pricingType" type="PricingType">
      FREE, PAID, or CUSTOM
    </ParamField>

    <ParamField body="maxQuantity" type="Float">
      Maximum quantity per subscription
    </ParamField>

    <ParamField body="billingId" type="String">
      Billing provider ID
    </ParamField>

    <ParamField body="dependencies" type="[String]">
      Required addon IDs
    </ParamField>

    <ParamField body="additionalMetaData" type="JSON">
      Custom metadata
    </ParamField>

    <ParamField body="environmentId" type="UUID">
      Environment ID
    </ParamField>
  </Expandable>
</ParamField>

## Return Type

Returns the created `Addon` object in DRAFT status.

## Related Operations

* [Set Package Pricing](/api-and-sdks/api-reference/mutations/set-package-pricing) - Add pricing
* [List Addons](/api-and-sdks/api-reference/queries/list-addons) - Query addons