Webhooks
Relograde sends webhook updates on specific events. On this page you can see an overview of our webhooks.
Product Catalogue Updated Webhook
Relograde sends a webhook notification when the price or stock availability of one or more products in our catalogue changes. To enable it, create or edit an API key at the Relograde Console and set your own endpoint.
Every 5 minutes our system compares the current catalogue against the last snapshot sent to you. When a product's price moves by more than your configured threshold (see below) or a product goes in or out of stock, our system sends a POST request with a content type application/json body to your endpoint. The response of your endpoint will be ignored.
Price change threshold
A notification is sent when a product's price moves by more than a threshold percentage. This filters out sub-percent drift caused by FX rate movements.
By default the threshold is set globally by Relograde. You can configure your threshold in your company settings at the Relograde Console Company Page
Notes
- The notification is intentionally simple. It is suggested you call the find-product endpoint for each returned slug to get the updated details.
- Relograde webhook notifications will be sent by the following ip:
18.195.134.217.
Example body
{
"event": "PRODUCT_CATALOGUE_UPDATED",
"apiKeyDescription": "Test key",
"data": [
"amazon-nl-25-eur",
"spotify-eu-10-eur"
]
}Fields
Prop
Type
Finished Order Webhook
Relograde offers a Webhook feature that allows users to receive a notification when an order reaches the finished status. To enable WebHook notifications, create a new API key or edit your existing API key at the Relograde Console and enter your own endpoint.
As soon as an order has been confirmed and reaches the finished status, our system will send a POST request with a content type application/json body to your endpoint. The response of your endpoint will be ignored.
Example body
{
"event": "ORDER_FINISHED",
"state": "sandbox",
"apiKeyDescription": "Test key",
"data": {
"trx": "RELO0TFQK8FXQXSPURM",
"reference": "test reference"
}
}Fields
Prop
Type
Prop
Type
Notes
- The notification is very simple. It is suggested you call the find-order endpoint to get details about the order.
- Relograde webhook notifications will be sent by the following ip:
18.195.134.217.