GyftBox

Partner intake

Generate unique redemption codes on demand, or bring your own.

Generate codes

We create unique GYFT-XXXX-XXXX codes and hand them straight back to you.

Your key is sent only with this request and is never stored in the browser.

Gift type

Upload a code batch

Already have your own codes? Import them by CSV.

Your key is sent only with this upload and is never stored in the browser.

Gift type

Generate via API

POST /api/partner/codes/generate
Authorization: Bearer gyft_sk_...
{ "count": 100, "eventName": "Coldplay" }

Returns a JSON array of unique single-use codes. Each code uses digits 1-9 and letters A-Z.

CSV format

code,event_name,event_venue,event_date,external_ref
GYFT-ABCD-1234,Coldplay,Wembley Stadium,2027-08-18,ORDER-101

The code column can be blank; GyftBox will generate a unique code. Dates use YYYY-MM-DD.

API ready

Query status any time at /api/partner/codes/[code]. Authenticate with a Bearer API key.