Skip to main content
POST
/
api
/
v1
/
zapier
/
actions
/
send_bulk_vouchers
Send Bulk Gift Card Vouchers
curl --request POST \
  --url https://api.ugift.me/api/v1/zapier/actions/send_bulk_vouchers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "vouchers": [
    {
      "productCode": "AMAZON-GIFT-001",
      "merchant": "Amazon UK",
      "currency": "GBP",
      "valuePurchased": 50,
      "recipientEmail": "[email protected]",
      "recipientName": "John Recipient",
      "message": "Thank you for your business!"
    }
  ],
  "campaignName": "Q4 Employee Rewards",
  "notes": "Bulk order for employee recognition"
}
'
{
  "success": true,
  "action": "send_bulk_vouchers",
  "data": {
    "campaignName": "Q4 Employee Rewards",
    "notes": "Bulk order for employee recognition",
    "totalVouchers": 3,
    "vouchersSent": 3,
    "vouchersFailed": 0,
    "results": [
      {
        "voucherIndex": 0,
        "recipientEmail": "[email protected]",
        "voucherId": "voucher_12345",
        "status": "sent",
        "sentAt": "2024-01-15T10:30:00.000Z"
      }
    ],
    "sentAt": "2024-01-15T10:30:02.000Z"
  }
}

Authorizations

X-API-Key
string
header
required

Your uGiftme business API key for authentication.

Format: UUID format (e.g., 6b4e22b2-c0a5-4c7a-888a-b38eac20b454) Required: All endpoints require this header Permissions: Must have business-level access with Zapier integration permissions

Example: X-API-Key: 6b4e22b2-c0a5-4c7a-888a-b38eac20b454

Body

application/json
vouchers
object[]
required

Array of vouchers to send

Required array length: 1 - 100 elements
campaignName
string

Name of the campaign for bulk vouchers

Maximum string length: 100
Example:

"Q4 Employee Rewards"

notes
string

Additional notes for the bulk order

Maximum string length: 500
Example:

"Bulk order for employee recognition"

Response

Bulk vouchers sent successfully

success
boolean
required

Indicates if the bulk vouchers were sent successfully

Example:

true

action
string
required

The action that was executed

Example:

"send_bulk_vouchers"

data
object