---
title: "Issue a gift card by hand, for goodwill or a refund as credit, on any plan: it's from your business, and who it's for is emailed the code. Logs gift_card.issued"
method: POST
path: "/gift_cards"
tags: ["gift_cards"]
---

# Issue a gift card by hand, for goodwill or a refund as credit, on any plan: it's from your business, and who it's for is emailed the code. Logs gift_card.issued

`POST /gift_cards`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/gift_cards`
- Auth: HTTP bearer

## Request body

- object
  - `amount_cents` integer, required: What it's worth, in the currency's minor units (cents; whole yen for zero-decimal currencies), in your currency
  - `for_name` string: Who it's for, as the email greets them
  - `for_email` string, email, required: Who it's for: emailed the code
  - `message` string: A line for them in the email

## Response `201`

Success

- object
  - `id` string, required
  - `org_id` string, required
  - `code` string, required: 12 characters of Crockford base32, as made: guests give it as they book (bookings.create's gift_card_code), in any case, spaced or not
  - `amount_cents` integer, required: What it was worth when made, in the currency's minor units (cents; whole yen for zero-decimal currencies)
  - `currency` string, required: ISO 4217, lowercase: the org's when it was made
  - `for_name` string, required: Who it's for, as given; may be empty
  - `for_email` string, required: Who it's for: emailed the code when it was made
  - `from_name` string, required: Who it's from: the buyer, or your business for one you issued
  - `from_email` string, required
  - `message` string, required: The buyer's message to who it's for, up to 300 characters; may be empty
  - `issued_by` 'purchase' | 'business', nullable, required: purchase: bought on your booking page; business: issued by you (gift_cards_issue)
  - `checkout_session_id` string, nullable, required: A bought card's Stripe Checkout, on your account
  - `payment_intent_id` string, nullable, required: A bought card's Stripe payment, on your account
  - `created_at` string, required: ISO 8601 timestamp (UTC)
  - `balance` integer, required: What's on it: the sum of its entries, in the currency's minor units (cents; whole yen for zero-decimal currencies). Gift cards never expire
  - `available` integer, required: What it can spend now: the balance less the parts of live holds that take it once they're confirmed, in the currency's minor units (cents; whole yen for zero-decimal currencies)

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)