---
title: "POST /teams/{team_name}/addon-orders"
method: POST
path: "/teams/{team_name}/addon-orders"
tags: ["addons"]
---

# POST /teams/{team_name}/addon-orders

`POST /teams/{team_name}/addon-orders`

Start the checkout process for an addon order.

## Path parameters

- `team_name` string, required — The unique name for the team.

## Request body

- AddonOrderCreate — Create CloudQuery Addon Order
  - `addon_team` string, required — The unique name for the team.
  - `addon_type` 'transformation' | 'visualization', required — Supported types for addons
  - `addon_name` string, required — The unique name for the addon.
  - `success_url` string, required — URL to redirect to after successful order completion
  - `cancel_url` string, required — URL to redirect to after order cancellation

## Response `201`

Response

- AddonOrder — CloudQuery Addon Order
  - `id` string, uuid, required — ID of the addon order
  - `team_name` string, required — The unique name for the team.
  - `addon_team` string, required — The unique name for the team.
  - `addon_type` 'transformation' | 'visualization', required — Supported types for addons
  - `addon_name` string, required — The unique name for the addon.
  - `status` 'pending' | 'completed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `completed_at` string, date-time
  - `completion_url` string, uri — Stripe URL for completing purchase. Only shown in response to POST request.

## Other responses

- `400` — Bad request
- `401` — Requires authentication
- `404` — Resource not found
- `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)