> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/api-guides-en/back-office/marketing-bo/gift-event-management.md).

# Gift Event Management

A gift event is a promotion in which a gift is given to customers. This registers and manages the information for the gift to be given, and lets you check which customers received the gift.

***

## Key Features

* Register and edit gift events.
* Look up ongoing or registered gift events, and look up information about the customers who received the gift.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FDrOcq7TE03VTyyobf7Dj%2F%E1%84%89%E1%85%A1%E1%84%8B%E1%85%B3%E1%86%AB%E1%84%92%E1%85%A2%E1%86%BC%E1%84%89%E1%85%A1%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%87%E1%85%A9%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&#x26;token=881686f4-2c3c-4118-90bf-92977779d17c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Gift Event Inquiry

Looks up registered gift event information

* You can look up information such as period, type, status, registrant, and the gift event's number/name.
  {% endstep %}

{% step %}

### Gift Event Registration/Edit

* Basic information, gift event payment settings, applicable target selection
  {% endstep %}

{% step %}

### Gift Recipient Customer Information Inquiry

* Looks up information such as order receipt date, order number, gift event number/name, and member ID/name
  {% endstep %}
  {% endstepper %}

## API Function List

<table><thead><tr><th width="133.4444580078125">API</th><th width="324.111083984375">Description</th><th width="93.5555419921875">Server</th><th width="89.1112060546875">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Gift Event Registration/Edit</td><td>Saves/edits the gift event information.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=registAppreciation">🔗View API ></a></td></tr><tr><td>Ongoing Gift Event Count Inquiry</td><td>Looks up the count of ongoing gift events<br>for which the gift is included in the event conditions</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getProgressAeEvtCount">🔗View API ></a></td></tr><tr><td>Gift Event Detail Information Inquiry</td><td>Looks up the detail information of the selected gift event</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciation">🔗View API ></a></td></tr><tr><td>Gift Event Management List Inquiry</td><td>Looks up the information of registered gift events</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciationEventList">🔗View API ></a></td></tr><tr><td>Gift Event Management Count Inquiry</td><td>Looks up the count of registered gift events.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciationEventListCount">🔗View API ></a></td></tr><tr><td>Gift Recipient<br>Customer Information Inquiry</td><td>Looks up the list of orders for which the gift was selected.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAeOrderList">🔗View API ></a></td></tr></tbody></table>