---
title: "Add gift card"
method: POST
path: "/gift_cards"
tags: ["Gift Cards"]
---

# Add gift card

`POST /gift_cards`

Create a new gift card. Vrio will generate a gift card code that can be used when processing orders.

## Request body

- object
  - `gift_card_total` string, required — Set the total amount for a gift card.
  - `date_expire` string, date-time — Set an expiration date for the gift card.
  - `gift_card_notes` string — Apply note to the history for this gift card.

## Response `200`

OK

- object
  - `gift_card_id` integer
  - `customer_id` integer, nullable
  - `gift_card_code` string
  - `gift_card_total` string
  - `gift_card_balance` string
  - `gift_card_active` boolean
  - `date_expire` string, date-time, nullable
  - `date_created` string, date-time
  - `created_by` integer
  - `date_modified` string, date-time
  - `modified_by` integer
  - `gift_card_notes` string, nullable

## Other responses

- `400` — Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/revisions/62037010356e/schema)