API Reference

Create gift card

post
https://{domain_prefix}.retail.lightspeed.app/api/2026-01/gift_cards

Creates and activates a new gift card. The gift card will be created with one transaction with status "ACTIVATION" which contains the initial balance of the gift card.

🔒 Requires: gift_cards:write:issue scope

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Create gift card parameters

The parameters taken by the create gift card API.

string
required

The initial balance to be loaded onto the gift card. Represented as a string for precision (e.g. "100.00").

string

The expiry date time of the gift card.

string
required

The unique number to assign to the gift card.

string

The timezone of the date times for the gift card.

uuid

The ID of the user creating the gift card.

Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?