đź”§ What Are Webhooks?
Webhooks are automated messages sent from Recognize to a third-party system in real-time when specific events occur—allowing your systems to stay connected without manual input. Below are some common use cases and technical details to help you get started.
đź’ˇ Common Use Cases for Recognize Webhooks
1. Rewards Fulfillment
Recognize Webhooks can be used to send redemption orders directly to a third-party fulfillment provider’s API. For example:
-
When an employee redeems a reward item in Recognize, a webhook can automatically trigger the associated swag storefront to fulfill the request.
-
This webhook sends the redemption details to the storefront, eliminating the need for manual processing by Company Admins.
-
The result is a seamless, automated experience for employees and admins alike.
2. Microsoft Teams Integration
If your organization uses Microsoft Teams, Recognize Webhooks can help amplify visibility and engagement:
-
Automatically post recognitions tied to specific teams in their respective Microsoft Teams channels (assuming team membership is mirrored in both platforms).
-
Create a general “Kudos” channel in Teams to automatically display all new recognitions from across the organization.
-
Automatically post new announcements from Recognize into a designated Teams channel as soon as they are published.
đź”” Available Webhook Events
Recognize can trigger webhooks based on the following events:
- Announcement published
- Recognition approved
- Recognition pending
- Redemption approved
- Redemption pending
- Redemption delivered
- Redemption canceled
- Redemption refunded
🛠️ Technical Requirements
To successfully implement webhooks with Recognize, the receiving system must meet the following requirements:
-
The third party (e.g., swag provider) must have an API capable of receiving webhook calls.
-
The API must support RESTful (GET or POST) requests and accept JSON-formatted data.
-
Authentication is optional, but can be configured if required.
-
The data payload is fully customizable. Recognize can tailor the webhook format to meet the exact specifications of the third-party provider.
🚀 How to Set Up Webhooks with Recognize
To get started:
-
Email us at support@recognizeapp.com
or -
Reach out to your Customer Success Manager (if you are currently onboarding).
We'll review your use case and schedule a time to walk through the setup process if needed.