Bonusly
Getting Started with Bonusly
The Bonusly modules allow you to watch, list, search and retrieve users, achievements, bonus details in your Bonusly account.
Prerequisites
- A Bonusly account
In order to use Bonusly with Integromat, it is necessary to have a Bonusly account. If you do not have one, you can create a Bonusly account at https://bonus.ly/sign_ups/.
Connecting Bonusly to Integromat
To connect your Bonusly account to Integromat you need to obtain the Access Token from your Bonusly account and insert it in the Create a connection dialog in the Integromat module.
1. Log in to your Bonusly account and open your Dashboard.
2. Click your Profile Icon > Settings > Services.
3. Click Create New API Access Token.
4. Enter a name for token and click Create API Key.
5. The acess token has been successfully created. Copy the token to your clipboard.
6. Go to Integromat and open the Bonusly module's Create a connection dialog.
7. In the Connection name field, enter a name for the connection.
8. In the Access Token field, enter the token copied in step 5.
9. Click Continue.
The connection has been established.
Achievement
Watch New Achievements
Triggers when an achievement is earned.
Webhook Name | Enter a name for the webhook. |
Connection | Establish a connection to your Bonusly account. |
List Achievements
Lists the 50 most recent achievements
Connection | Establish a connection to your Bonusly account. |
Limit | The maximum number of achievements Integromat should return during one scenario execution cycle. |
List User Achievements
Lists achievements for a particular user.
Connection | Establish a connection to your Bonusly account. |
User ID | Select the user whose achievements you want to list. |
Limit | The maximum number of user achievements Integromat should return during one scenario execution cycle. |
Bonus
Watch New Bonus
Triggers when a bonus is given.
Webhook Name | Enter a name for the webhook. |
Connection | Establish a connection to your Bonusly account. |
List Bonuses
List all bonuses.
Connection | Establish a connection to your Bonusly account. |
Giver Email | Enter the giver email address to list all the bonuses associated with it. |
Receiver Email | Enter the receiver email address to list all the bonuses associated with it. |
Giver or Receiver Email | Enter a giver or a receiver email address to list all the bonuses associated with it. |
Start Time | Enter the bonus start time you want to list. |
End Time | Enter the end time of the bonus you want to list. |
Hashtag | Enter the Hashtag reason to list bonuses associated with it. |
Limit | The maximum number of bonuses Integromat should return during one scenario execution cycle. |
List User Bonuses
Lists all bonuses of a particular user.
Connection | Establish a connection to your Bonusly account. |
User ID |
Select the User ID whose bonus information you want to list. |
Role | Select the user role in the organization. |
Start Time | Enter the start time of the bonus period. |
End Time | Enter the end time of the bonus period. |
Hashtag | Enter the reason for the bonus by using Hashtag. |
Limit | The maximum number of user bonuses Integromat should return during one scenario execution cycle. |
Get a Bonus
Reads a particular bonus.
Connection | Establish a connection to your Bonusly account. |
Bonus ID |
Select the Bonus ID whose details you want to retrieve. |
Give a New Bonus
Recognizes a colleague by giving them a new bonus.
Connection | Establish a connection to your Bonusly account. |
Giver Email |
Enter the email address who is giving a bonus. |
Reason | Enter the reason for giving the bonus. |
Add On an Existing Bonus
Adds on an existing bonus to a colleague.
Connection | Establish a connection to your Bonusly account. |
Giver Email |
Enter the email address who is giving a bonus. |
Reason | Enter the reason for adding the additional bonus. |
Parent Bonus ID | Select the Parent Bonus ID to which this is an Add On Bonus. |
Delete a Bonus
Deletes a particular bonus.
Connection | Establish a connection to your Bonusly account. |
Bonus ID |
Select the Bonus ID you want to delete. |
User
List Users
Lists all users.
Connection | Establish a connection to your Bonusly account. |
Enter the email address of the users you want to list. | |
User Mode | Enter the user mode. You can add multiple modes separated by a comma. For example, normal, observer, receiver, benefactor, and bot. |
Include Archived | Select whether you want to list the archived users:
|
Show Financial Data | Select whether you want to display the user financial data:
|
Limit | The maximum number of users Integromat should return during one scenario execution cycle. |
Search Users
Finds users by name or email.
Connection | Establish a connection to your Bonusly account. |
Enter the email address of the users you want to search for. | |
Limit | The maximum number of users Integromat should return during one scenario execution cycle. |
Other
Make an API Call
Performs an arbitrary authorized API call.
Connection | Establish a connection to your Bonusly account. |
URL |
Enter a path relative to For the list of available endpoints, refer to the Bonusly API Documentation.
|
Method |
Select the HTTP method you want to use: GET POST PUT PATCH DELETE |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List Bonuses
The following API call returns all the bonuses from your Bonusly account:
URL:
/bonuses
Method:
GET
Matches of the search can be found in the module's Output under Bundle > Body > result.
In our example, 20 bonuses were returned: