Why a Partner API?
Many of our clients have asked for a way to connect their own systems — CRMs, ERPs, data warehouses, and custom dashboards — directly to Incentit without manual exports or screen-scraping. The Partner API makes that possible.
Whether you need to sync account data nightly, pull incentive statuses into your internal reporting, or build a custom portal that reads from Incentit in real time, the API gives you a clean, documented interface to do it.
What You Can Do
Search Accounts
Find accounts by ID, name prefix, postal code, parent account, or last-modified date. Paginate through large result sets with skip/take parameters and sort by account ID, name, or updated date.
Search People
Look up contacts by first name, last name, email, organization, or account. Filter to only users with portal access or those pending registration.
Search Incentives
Query incentives by account, program, workflow status, date range, amount range, item, brand, model, or serial number. The response includes the key fields you need — account, promotion, status, amount, and closing period.
Get Incentive Detail
Pull the full record for a single incentive including line items, relationships, documents, and current workflow state.
Bulk Export
Retrieve all incentives from a pre-built, indexed snapshot optimized for large data pulls. Paginate up to 1,000 records per request without impacting live system performance.
Authentication
The API uses JWT Bearer tokens. Post your credentials to get a token that lasts 8 hours, then include it in the Authorization header on every request. A refresh endpoint lets you extend your session without re-entering credentials.
Built for Your Hierarchy
All data is automatically scoped to your tenant. If you're a 2nd-tier partner account, you see your accounts and their children — nothing outside your hierarchy. No extra filtering required on your end.
Getting Started
If you're a current Incentit client and want API access, reach out to your account representative. We'll set up credentials and walk you through the endpoints. Full documentation with request/response examples is available in the Partner Integration Guide.
The Partner API is available now in both our QA and production environments.
What's Next
We're actively expanding the API surface. Upcoming additions include endpoints for creating and updating accounts, submitting incentives programmatically, and webhook notifications for status changes. Stay tuned.