Moving from Zapier to the Bonusly API
Bonusly’s Zapier integration is no longer actively supported. If your team uses Zapier to connect Bonusly with other tools, you can keep building custom workflows with the Bonusly API instead.
The API gives your team more control over how data moves in and out of Bonusly. You can use it to give recognition, pull recognition data, look up users, and build custom workflows with the tools your team already uses.
This guide walks through the basics of moving common Zapier workflows to the Bonusly API. For more detail on creating API tokens and making requests, see our guide: Connecting to the Bonusly API.
What’s changing
The Bonusly Zapier integration is no longer actively supported.
Existing Zaps may continue to work, but we recommend moving any important workflows to the Bonusly API. This gives your team a more reliable way to maintain custom workflows over time.
Who should use the API
The Bonusly API is best for teams that have access to a developer, IT admin, or technical partner who can build and maintain custom workflows.
You might use the API to:
Give recognition from another internal tool
Pull recognition data into a reporting workflow
Connect Bonusly to an HRIS, intranet, or custom app
Build a custom automation that replaces an existing Zap
Before you start
You’ll need:
A Bonusly account with the right admin permissions
An API access token
Someone comfortable working with REST APIs and JSON
Access to the tool or system you want to connect to Bonusly
Create an API access token
For step-by-step API setup instructions, see Connecting to the Bonusly API.
Go to https://bonus.ly/api
Select Create New API Access Token.
Choose the access level your workflow needs.
Store the token somewhere secure.
For security, Bonusly only shows read/write access tokens once. If you lose a token, you’ll need to create a new one.
Use the token in the Authorization header:
Authorization: Bearer YOUR_API_TOKEN
Replacing common Zapier workflows
The Bonusly Zapier integration supported a few common workflows. You can recreate each one with the Bonusly API.
If your Zap used “New Bonus”
Use Bonusly webhooks to listen for new recognition.
Event type:
bonus.createdAPI endpoint:
POST /api/v1/webhooksAPI documentation: Bonusly API docs
One thing to note: Zapier renamed a few fields before sending data to later Zap steps. If you move to the API directly, you’ll receive the raw Bonusly webhook payload instead. For example, fields like family_amount and child_count may appear differently than they did in Zapier.
If your Zap used “New Achievement”
Use Bonusly webhooks to listen for new achievement events.
Event type:
achievement_event.createdAPI endpoint:
POST /api/v1/webhooks
The raw API payload may use slightly different field names than the Zapier version. For example, Zapier displayed the achievement user as receiver, while the API payload may use the underlying user field.
If your Zap used “Give Bonus”
Use the Create a Bonus endpoint.
API endpoint:
POST /api/v1/bonusesAPI documentation: Create a Bonus
Your request can include details like the reason, receiver, amount, and hashtag.
If your Zap used “Give Bonus From Text”
Use the same Create a Bonus endpoint.
API endpoint:
POST /api/v1/bonuses
Instead of sending the amount, receiver, and hashtag as separate fields, include the full recognition message in the reason field, like:
+10 @alex for helping launch the campaign #teamwork
Bonusly will parse the amount, receiver, and hashtag from the text.
If your Zap used “Find User”
Use the user autocomplete endpoint to look up a person by name or email.
API endpoint:
GET /api/v1/users/autocomplete
This is helpful when your workflow needs to find a Bonusly user before giving recognition or matching data from another system.
Test your new workflow
Before turning off your Zap, test your API workflow with a small example.
We recommend checking that:
The API token has the right permissions
Requests use the
AuthorizationheaderThe workflow handles failed API responses
The workflow does not create duplicate recognition
The right person or system owns the API token
Need help?
If you’re not sure how to replace your Zapier workflow, contact us at [email protected]. Include a short description of what your Zap does today, and we’ll point you toward the best API option.
