---
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

---

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