Build with IncentiveSupply APIs
Comprehensive APIs, SDKs, and developer tools to integrate rewards and corporate gifting into any application.
Get started in minutes
Our REST APIs are designed for developers. Get up and running with just a few lines of code.
npm install @incentivesupply/sdk
import { IncentiveSupply } from '@incentivesupply/sdk'
const client = new IncentiveSupply({
apiKey: process.env.INCENTIVE_SUPPLY_KEY
})
// Create a personalized offer
const offer = await client.offers.create({
audience: 'premium_users',
budget: 250,
region: 'US',
occasion: 'milestone_reward'
})
console.log(offer.mockup_url)
console.log(offer.products)API Reference
Complete documentation for all endpoints and resources
Offers API
CoreCreate and manage personalized gift offers
Products API
CoreBrowse catalog and get product details
Orders API
CorePlace orders and track fulfillment
Analytics API
PremiumGet insights and performance metrics
Webhooks API
CoreReal-time event notifications
Admin API
EnterpriseAccount and billing management
Official SDKs
Native libraries for your favorite programming languages
Node.js
npm install @incentivesupply/nodePython
pip install incentivesupplyPHP
composer require incentivesupply/phpRuby
gem install incentivesupplyWebhooks & Events
Stay in sync with real-time notifications for order updates, fulfillment status, and more.
order.created - New order placedorder.fulfilled - Order shippedorder.delivered - Order deliveredoffer.expired - Offer expiredproduct.updated - Catalog changes{
"event": "order.fulfilled",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"order_id": "ord_abc123",
"tracking_number": "1Z999AA1234567890",
"carrier": "UPS",
"estimated_delivery": "2024-01-18",
"recipient": {
"name": "John Doe",
"email": "john@example.com"
}
}
}Developer Guides
Step-by-step tutorials and best practices
Building a Rewards System
Complete guide to implementing player rewards in gaming applications
Corporate Gifting Integration
Add corporate gifting features to your HR or CRM platform
Advanced Personalization
Leverage AI recommendations and user behavior data
Webhook Best Practices
Reliable event handling and error recovery strategies
Try our Sandbox
Test your integration with our full-featured sandbox environment. No real orders, no real charges.
Changelog
Stay updated with the latest API changes and new features
- Added AI personalization endpoints
- New webhook events for delivery tracking
- Fixed pagination in products API
- Improved error messages for invalid regions
- New authentication system
- Updated response formats
- Deprecated v1 endpoints