Skip to main content
POST
Create a gift card listing

Autorisierungen

Authorization
string
header
erforderlich

Your API key, from the cabinet under Seller → API keys.

Body

application/json

A gift card is one redemption code, handed over instantly — there is no delivery type to pick and no handover time to promise.

game
string
erforderlich

The game's slug.

title
string
erforderlich
Required string length: 8 - 128
price
integer<int64>
erforderlich

US cents.

delivery_method
string
erforderlich

A key from GET /v1/offers/delivery-methods — activation_code.

units
object[]
erforderlich

The codes themselves, one opaque JSON payload each. Encrypted at rest; never read back.

Minimum array length: 1
description
string
Maximum string length: 4096
images
string<uri>[]

Optional — the marketplace renders the pack tile.

Maximum array length: 10
tags
string[]

Up to 500 characters in all, counted as the tags joined with ", ". No commas inside a tag. Stored trimmed, lower-cased and deduplicated.

attributes
object

The category's own fields — read them from its schema.

Antwort

Created

What every category's listing carries, whatever it sells.

id
string<uuid>
title
string
description
string
attributes
object

The category's own fields, keyed by the schema's key.

tags
string[]
status
enum<string>

draft on create, then active once you publish it; unpublish takes it back to draft. archived is yours too, through DELETE. sold follows an order: the last unit went to a closed one. changes_requested is moderation sending a live listing back: it is off the marketplace, moderation_reason_code says why, and your next PATCH makes it a draft to publish again.

Verfügbare Optionen:
draft,
active,
changes_requested,
sold,
archived
created_at
string<date-time> | null
updated_at
string<date-time> | null
published_at
string<date-time> | null

When publish put it on the marketplace. null while it is a draft, and written once — pausing and unpausing leave it alone.

moderation_reason_code
enum<string> | null

Why moderation asked for changes. Kept through the PATCH that makes the listing a draft, null once it is published again.

Verfügbare Optionen:
prohibited_item,
misleading_description,
stolen_images,
invalid_price,
insufficient_details,
other,
null
moderation_note
string | null

What moderation wrote to you along with the reason, if anything.

price
integer<int64>

US cents.

currency
string

Always USD.

Beispiel:

"USD"

images
string<uri>[]
delivery_method
string | null

The key this listing hands over by.