---
title: "POST /addons"
method: POST
path: "/addons"
tags: ["addons"]
---

# POST /addons

`POST /addons`

Create an addon owned by the specified team. User must be part of that team.

## Request body

- AddonCreate — CloudQuery AddonCreate
  - `team_name` string, required — The unique name for the team.
  - `name` string, required — The unique name for the addon.
  - `category` 'cloud-infrastructure' | 'databases' | 'sales-marketing' | 'engineering-analytics' | 'other', required — Supported categories for addons
  - `addon_type` 'transformation' | 'visualization', required — Supported types for addons
  - `addon_format` 'zip', required — Supported formats for addons
  - `tier` 'free' | 'paid', required — Supported tiers for addons
  - `price_usd` string — The price for 6 months
  - `short_description` string, required
  - `display_name` string, required — The addon's display name
  - `homepage` string
  - `repository` string
  - `logo` string
  - `public` boolean, required — Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the plugin's team.

## Response `201`

Created

- Addon — CloudQuery Addon
  - `team_name` string, required — The unique name for the team.
  - `name` string, required — The unique name for the addon.
  - `official` boolean, required — True if the addon is maintained by CloudQuery, false otherwise
  - `category` 'cloud-infrastructure' | 'databases' | 'sales-marketing' | 'engineering-analytics' | 'other', required — Supported categories for addons
  - `addon_type` 'transformation' | 'visualization', required — Supported types for addons
  - `addon_format` 'zip', required — Supported formats for addons
  - `tier` 'free' | 'paid', required — Supported tiers for addons
  - `price_usd` string, required — The price for 6 months
  - `short_description` string, required
  - `display_name` string, required — The addon's display name
  - `homepage` string
  - `repository` string
  - `logo` string, required
  - `public` boolean — Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the plugin's team.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `422` — UnprocessableEntity
- `500` — Internal Error

---

[API](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec.md) · [All operations](https://skmtc.dev/cloudquery/apis/cloudquery-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudquery/cloudquery-openapi-spec/revisions/ef9782a3ed5e/schema)