GovRewards (Trigger)
The GovRewards Trigger Node enables your workflow to receive event notifications from GovRewards, Singapore Government’s rewards and incentives platform. When a reward event occurs (such as redemptions or point transactions), the configured webhook triggers your workflow to process the event.
Note: GovRewards is a platform for managing government rewards and incentive programs. For an overview of all input types, see Configure Workflow Input.
GovRewards Support: For any enquiries or issues related to GovRewards, please reach out to the GovRewards team via go.gov.sg/govrewards-report-issue.
How Does It Work?
The GovRewards Trigger Node acts as a webhook endpoint that receives POST requests whenever a reward-related event occurs in the GovRewards platform. It processes the incoming event data and makes it available to subsequent nodes in your workflow.
Setup Steps:
- Click on Select Input
- Choose GovRewards as the trigger node
- Open the trigger node Settings
- Copy the webhook endpoint URL provided by the trigger node
- In the GovRewards platform, configure the webhook to point to the OPUS webhook endpoint URL
- Publish your workflow in OPUS to activate the webhook connection
Output:
The GovRewards Trigger Node returns the event data in the format provided by the GovRewards platform.
Runtime URL
The trigger node provides runtime URLs for invoking your workflow in different environments:
- Staging URL: Used for testing in the staging environment
- Production URL: Used for live production workflows
The URL format indicates the specific branch or release version:
mainbranch for development- Release versions (e.g.,
release/1.0.0) for production deployments
Note: The endpoints below are for Lite tier reference only. Always refer to the endpoint URL shown in your node settings.
| Environment | Endpoint URL |
|---|---|
| Staging | https://lite.staging.oes.opus.gov.sg/api/govrewards/<namespace-id>/<project-id>/<entity-id>?branch=main |
| Production | https://lite.production.oes.opus.gov.sg/api/govrewards/<namespace-id>/<project-id>/<entity-id>?branch=main |
Query Parameters:
| Parameter | Description |
|---|---|
branch |
The branch or release version (e.g., main, release/1.0.0) |
identifier |
Optional. Custom identifier that appears in the monitoring page for easier tracking |
Example:
https://lite.production.oes.opus.gov.sg/api/govrewards/namespace01/project01/cmisfd7yx000h8u01dpzdrbw4?branch=mainWhen to Use It?
Use GovRewards Trigger Node when:
- You need to automate processing of reward events and transactions.
- You are managing rewards through GovRewards and want to trigger automated workflows.
- You want to integrate reward redemptions with backend systems, databases, or notifications.
- You need real-time processing of reward events (e.g., sending confirmations, updating records, triggering fulfillment).
- You want to automate incentive program workflows and reward distributions.