Hooks API
DeliverCustomReward1
Notifies that a custom reward has been unlocked by a customer.
Method | POST |
---|---|
Kind | Mutation Hook |
URL | The webhook URL you specify, with :name replaced by DeliverCustomReward1 |
Authentication | JWT HS256 Bearer token |
Custom rewards is an advanced feature enabled by Bubblehouse upon request. We will help you set it up.
Input
reward_identifier
stringrequiredThe reward identifier you have configured. To Bubblehouse, this is an opaque string.
reward_title
stringrequiredThe title of the reward in question.
Time when the customer got access to this reward.
The customer who has unlocked the reward.
Output
delivered
booleanrequiredWhether you succeeded in delivering this reward to the user. Pass false to cause a refund and raise a failure.
message
stringoptionalAn optional message to show to the user. Depending on the delivered flag, this will be an error message or a success message.
notes
stringoptionalExtra non-public information to record, visible to the staff.
Specific Errors
Status | Error | Reason & Examples |
---|---|---|
None. |
API-wide Errors
Status | Error | Reason & Examples |
---|---|---|
None. |
Global Errors
Status | Error | Reason & Examples |
---|---|---|
None. |