Create Gift

post

https://api.getkivly.com/api/v1/gift-cards

Create a gift-card product. price_cents and balance_cents use minor currency units; no issued card or payment is created by this operation.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Input model for creating gift card

location_id

type

string

enum

required

Gift card type enumeration

Allowed:

name

string

required

description

image_url

price_cents

integer

required

expires_at

valid_from

valid_until

balance_cents

experience_config

ExperienceConfig | null

event_config

EventConfig | null

discount_type

DiscountType | null

discount_value

discount_buy_x

discount_get_y

conditions

CouponConditions | null

pack_config

PackConfig | null

can_be_gifted

can_be_shared

requires_reservation

add_to_wallet

availableOnOnlineStore

201Successful Response

401Authentication credentials were missing, invalid, or expired.

403The authenticated integration does not have access to this resource.

404Resource not found in the integration location.

409Action conflicts with the current resource state; reconcile before retrying.

422Validation Error

429Too many requests. Retry after the period indicated by the API.

500Unexpected server error.

503Shared integration limiter unavailable. Retry after the indicated delay.