Skip to main content

Moving from Zapier to the Bonusly API

Recreate your existing workflows with Bonusly’s API tools

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.

  1. Select Create New API Access Token.

  2. Choose the access level your workflow needs.

  3. 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.created

  • API endpoint: POST /api/v1/webhooks

  • API 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.created

  • API 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.

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 Authorization header

  • The 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.

Did this answer your question?