Employee Gifting API: Build Milestone-Triggered Gift Delivery into Your HRIS

Your HR platform already knows every moment that matters: the hire date, the one-year mark, the promotion, the performance review that cleared. Right now, most platforms send an email for those moments. An email is fine. A real physical gift, delivered automatically to the employee's door, is a signal the platform remembered. This post is for the engineers building that signal.

The Problem with Building This Yourself

Gifting sounds like a solvable feature. It is not. The surface area is much larger than it appears.

To ship employee gifting natively, your team needs to manage a product catalog (sourcing, pricing, inventory status, and vendor contracts across hundreds of brands), a payment processing layer, a fulfillment pipeline, international shipping carriers and customs documentation, a returns workflow, and a customer support queue for when a package is delayed or wrong. That is a full logistics operation sitting inside your HR product roadmap.

Most teams scope it, price it, and push it to the next quarter indefinitely. The RealGifts enterprise gifting API is the alternative: embed a complete gifting stack into your platform via API, skip building the infrastructure, and earn commissions on every order your users place.

How Milestone-Triggered Gifting Works via API

The integration pattern is event-driven. Your HRIS already fires events for the moments that matter. You connect those events to the RealGifts API and define what happens next.

A typical milestone flow looks like this:

1. Your platform fires a lifecycle event (hire anniversary reached, performance review completed, birthday on record).
2. Your event handler calls the RealGifts API with the recipient identifier, the gift tier or specific catalog item, and the delivery address (or a redemption-link flow if the address is not on file).
3. RealGifts handles catalog availability, payment processing, fulfillment, and shipping. Your platform receives order confirmation and tracking data via webhook callback.
4. The employee receives the gift and your platform records the recognition event, with no manual intervention from your team after initial setup.

The trigger logic lives entirely in your system. You decide which events qualify, which gift tiers map to which milestones, and whether the manager gets an approval step before the order fires. RealGifts handles everything downstream from the API call.

What the Integration Looks Like

Here is the core shape of a milestone-triggered gift order request:

{
  "event": "employee.anniversary",
  "recipient": {
    "employee_id": "emp_8821",
    "name": "Jordan Lee",
    "email": "jordan.lee@company.com"
  },
  "gift": {
    "catalog_item_id": "gift_anniversary_1yr",
    "value_usd": 75.00
  },
  "fulfillment": {
    "address": {
      "line1": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "OR",
      "zip": "97477",
      "country": "US"
    }
  },
  "metadata": {
    "platform_event_id": "evt_20260115_ann_8821",
    "triggered_by": "hris_anniversary_job"
  }
}

Authentication uses API keys scoped per operator account. You can run against the sandbox environment during development; the sandbox fires real webhook callbacks with simulated fulfillment state so your event handlers can be tested end to end before going live.

Key integration surfaces:

• Catalog API: Query available gifts by category, value range, or occasion tag. RealGifts maintains the catalog (1M+ gifts across hundreds of brands); you surface it through your own UI or let the operator configure a curated subset per milestone type.
• Order API: Place orders, poll status, and receive fulfillment updates via webhook. Order records include item value, shipping cost, and carrier tracking, which your platform can expose to the manager or HR admin.
• Redemption links: When a home address is not on file, issue a redemption link the employee clicks to enter their own address and select from a curated set of options, removing any address collection requirement at the platform level.
• White-label UX: The gift selection and redemption surfaces run under your brand. Your users see your product, not a third-party widget.
• Webhook event model: RealGifts posts order status updates (confirmed, shipped, delivered, failed) to your configured endpoint. Your platform can update recognition records and trigger follow-on actions (manager notification, points award, HR record update) off those callbacks.

The RealGifts SDK covers JavaScript, Node.js, PHP, Python, Ruby, and Perl, plus native iOS and Android libraries. You can also call the REST API directly. The 3-line JavaScript embed covers the lightest integration case; full webhook-driven automation uses the REST API with server-side event handling.

Tax and Compliance Considerations

Employee gifts are taxable compensation under US tax law above certain thresholds. For non-cash gifts, the IRS requires employers to include gift value in employee wages above the de minimis threshold, and gifts valued above $600 in a calendar year trigger a 1099-NEC filing obligation. These rules live at your platform layer, not inside RealGifts.

RealGifts provides complete order records via API and export: item value, shipping cost, recipient identifier, and order date. Your platform or your enterprise customers handle the tax treatment and reporting logic. If your HRIS already manages W-2 or 1099 workflows, the gift order data slots into that pipeline directly.

For international deployments, gift value reporting obligations vary by jurisdiction. Build your tax handling to receive the value data from the RealGifts order record and apply the appropriate rules for each employee's country of residence at the platform layer.

Three Concrete Integration Scenarios

1. Hire Anniversary Recognition inside a Company HRIS

Your platform tracks tenure milestones. At the one-year mark (and at configured intervals thereafter), your job scheduler fires a gift order request. The gift tier, chosen by the HR admin at setup, maps to each anniversary level: a $50 item at year one, $100 at year three, $150 at year five. The employee receives a notification inside your platform and a physical gift at their door within the standard fulfillment window. The HR admin sees a recognition log entry with the order ID and delivery confirmation, with no manual coordination or gift card spreadsheets involved.

2. Birthday Gifting inside a Team Platform

Your team collaboration tool surfaces employee birthdays to managers. Rather than a notification the manager forgets to act on, your platform automatically places a modest gift order three days before the employee's birthday. The recipient gets a redemption link by email, picks from a curated selection you configured at setup, and enters their shipping address. Your platform records the interaction. The manager's only involvement is an optional approval step you can enable or disable per account.

3. Performance Milestone Rewards inside an LMS or Recognition Tool

A learner completes a certification track. Your LMS fires a completion event. Your event handler evaluates the milestone tier and calls the RealGifts order API with the corresponding reward. The learner sees a "Your reward is on the way" state inside the LMS UI. RealGifts handles fulfillment; your platform receives the tracking webhook and updates the learner's achievement record. For organizations using a physical reward as a behavioral incentive, the gift arrives as confirmation that the milestone was real and recognized, not just a badge on a screen.

Ready to Build?

RealGifts runs the catalog, payments, fulfillment, shipping, and support. You connect the events and earn commissions on every order. The Starter plan is $199/mo with a 14-day free trial and no credit card required.

Read the full API reference and get sandbox access at /developers. For enterprise procurement, custom catalog configuration, or volume pricing, see /solutions/enterprise or contact the enterprise team directly.

If you are evaluating HR platform gifting more broadly, the developer guide for wiring gifting into your HR platform covers platform selection criteria, API surface comparisons, and integration architecture for HRIS and recognition tools.