Sending Rewards

Step 1 — Choose a card type

Giftronaut supports two card types: Branded Card and Choice Card. If you're unsure which to use, Choice Card is the most commonly used option and works well when you want to give recipients flexibility.

Both card types require a productId — but they come from different catalogs.

You can also browse all available branded cards visually in the portal: Brand Catalog (Please note that the public catalog may not reflect real-time availability. For the most accurate and up-to-date catalog data, utilize the API.)

Branded Card order endpoint

POST /api/v1/orders/branded-cards — requires productId from the catalog.

{
  "productId": "GC-AMAZON-USD",
  "recipients": [
    { "firstName": "Alice", "email": "alice@giftronaut.com", "amount": 50 }
  ],
  ...
}

Choice Card order endpoint

POST /api/v1/orders/choice-cards — requires productId from the choice card catalog.

{
  "productId": "CHOICE-GLOBAL-USD",
  "recipients": [
    { "firstName": "Bob", "email": "bob@giftronaut.com", "amount": 100 }
  ],
  ...
}

Step 2 — Set up your delivery email

All gift cards are delivered by email. You can customize the sender name, subject line, message, brand logo, and colors using an email template.

Create a template

Templates control the banner image, layout, button colors, and border style of your delivery email. Create one with POST /api/v1/templates:

{
  "name": "Corporate Blue",
  "senderName": "Acme Corp",
  "message": "Enjoy your gift!",
  "imageAlignment": "center",
  "imageSize": 40,
  "borderColor": "#1F35FF",
  "buttonColor": "#1F35FF",
  "buttonFontColor": "#ffffff"
}

Save the templateId — you'll reference it when placing orders.

Template fields at a glance

Email template preview

Templates are applied to recipient emails as shown below.

How to change the email template logo image

1. Log in to the Giftronaut portal and go to the dashboard.
2. Navigate to Settings > Email Template.
3. Click the Create button.
4. Upload your logo image and click Save.
5. Use the generated Template ID to display the uploaded image in recipient emails.

‹ Prev 1 / 4 Next ›

Attach the template to an order

Include an emailSetting object in any order request to customize the delivery email:

{
  "productId": "CHOICE-GLOBAL-USD",
  "recipients": [ ... ],
  "emailSetting": {
    "senderName": "Acme Rewards",
    "subject": "Your reward is here!",
    "message": "Thank you for your contribution.",
    "templateId": "15"
  },
  ...
}

Step 3 — Specify your recipients

There are two ways to specify recipients. For a quick one-off send, include them inline. For recurring sends, build an address book.

Option A — Inline recipients (one-off sends)

Include the recipient list directly in your order request. Each recipient can receive a different denomination.

{
  "recipients": [
    { "firstName": "Alice", "lastName": "Kim", "email": "alice@giftronaut.com", "amount": 50 },
    { "firstName": "Bob",   "lastName": "Lee", "email": "bob@giftronaut.com",   "amount": 25 }
  ]
}

Option B — Recipient address book (recurring sends)

Save recipients via POST /api/v1/recipients and organize them into groups. Reference a group in your order to avoid re-submitting the same list every time.

Recipient Groups

Step 4 — Place the order

Now put it all together. Pass your productId, templateId, recipients, and (optionally) a scheduled send time.

curl -X POST "https://api.giftronaut.com/api/v1/orders/branded-cards" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{
    "idempotencyKey": "550e8400-e29b-41d4-a716-446655440000",
    "productId": "10042",
    "emailSetting": {
      "senderName": "Acme Rewards",
      "subject": "Your gift has arrived!",
      "message": "Thank you for your contribution.",
      "templateId": "15"
    },
    "sendTiming": {
      "type": "SCHEDULED",
      "scheduledAt": "2024-12-25T09:00:00",
      "timezone": "America/New_York"
    },
    "recipients": [
      { "email": "alice@giftronaut.com", "firstName": "Alice", "lastName": "Kim", "amount": 50 }
    ]
  }'