The Giftbit API lets you send rewards automatically through your own system. This is useful if you want full control over how rewards are triggered, delivered, and tracked.
Step 1: Create a sandbox (Testbed) account
Start by setting up a test environment where you can safely build and try your integration.
Go to testbed.giftbit.com
Register for a free sandbox account
Your Testbed account includes a virtual balance so you can test without using real funds.
Step 2: Generate your API Token
You’ll need an API token to authenticate your requests.
Log in to your Testbed account.
Click your username in the bottom left and go to API Keys.
Click Generate New Key in the top right and copy the token.
Step 3: Review the API documentation
Before building, take time to understand how the API works.
Visit: giftbit.com/giftbitapi
Review available endpoints and request formats.
Learn how to structure your API calls.
The documentation explains each endpoint and how to use it.
Step 4: Understand the Testbed environment
The Testbed environment simulates production, but there are a few key differences:
You have a fake balance for testing.
Credit card payments are simulated using Stripe test cards.
Rewards are not redeemable.
Reward emails are sent to your inbox, not recipients.
Rewards cannot be sent to external users.
Available reward brands are limited.
Processing times may differ from production.
You can preview the full production reward catalog at giftbit.com/rewards.
Step 5: Test your integration
Testing helps make sure your integration works reliably.
Build and send test API requests.
Confirm rewards are created as expected.
Add error handling to your system.
Tip
Be sure your integration can handle cases like:
Invalid recipient details.
Unavailable reward options.
This helps prevent failed reward deliveries.
Step 6: Go live in production
When you're ready to launch:
Sign up for a production account at www.giftbit.com (if you haven’t already).
Email testbed@giftbit.com to request API access.
You can include screenshots of your integration.
Once enabled:
Generate a production API token.
Recreate any reward templates from Testbed.
Call the
/brandsendpoint to get full reward data (images, descriptions, denominations).