---
title: "Register with a cloud marketplace"
method: POST
path: "/marketplace/register"
tags: ["Marketplace"]
---

# Register with a cloud marketplace

`POST /marketplace/register`

Links the authenticated user to a cloud marketplace subscription. Only one marketplace registration is allowed per user.

## Request body

- MarketplaceRegisterRequest — Request to register with a cloud marketplace
  - `marketplace` 'aws', required — Marketplace provider accepted for registration.
  - `company_name` string, required — Company name for the marketplace registration
  - `aws` object, required — AWS-specific marketplace details
    - `customer_id` string, required — AWS Marketplace customer ID
    - `product_id` string, required — AWS Marketplace product ID
    - `account_id` string, required — AWS account ID

## Response `200`

Marketplace registration successful

## Other responses

- `400` — Error returned when the request is malformed or contains invalid parameters
- `401` — Error returned when authentication or authorization fails
- `409` — Generic error response
- `502` — Marketplace registration provider failed

## Changes

- **2026-07-08** `bed0f79de08d` — 3 breaking
  - added `#/components/schemas/MarketplaceRegistrationProvider` to the `marketplace` request property `allOf` list
  - removed the enum value `aws` of the request property `marketplace`
  - the `marketplace` request property type/format changed from `string`/`` to ``/``
- **2026-04-15** `a2cc5189d200` — 2 breaking, 1 warning, 1 info
  - request property `marketplace` was restricted to a list of enum values
  - the `marketplace` request property type/format changed from ``/`` to `string`/``
  - removed `#/components/schemas/MarketplaceRegistrationProvider` from the `marketplace` request property `allOf` list
  - added the new `aws` enum value to the request property `marketplace`

[Change history](https://skmtc.dev/xataio/apis/xata-api/changes/marketplace/register/post.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) · [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/16b3a31dfdf8/schema)