Webhooks allow Pricer24 to automatically push price changes for your products directly to your server, eCommerce store, or internal pricing engine.

Instead of polling the API continuously, your application passively waits for incoming HTTP POST notifications whenever price modifications occur.

How Webhooks Work

1. Change Detection: When a product price changes in Pricer24 (e.g., as a result of Dynamic pricing calculation or manual edits in the catalog), an event is enqueued.
2. Batching: A background dispatcher runs every 2 minutes, grouping pending updates into batches of up to 100 items per request.
3. POST Request: Pricer24 sends an HTTP/HTTPS POST request with the batch payload to your registered webhook endpoint.
4. Acknowledgment (200 OK):
5. • If your endpoint responds with HTTP 200 OK (or 204 No Content), the batch is marked as delivered, and the queue proceeds.
   • If your server returns an error code (e.g., 500, 502) or fails to respond within 60 seconds, the transmission halts. During the next 2-minute cycle, the identical batch is retried until a 200 OK acknowledgment is received.

Payload Contract

Pricer24 sends POST requests with a JSON body structured as follows:

{
  "secret": "your_webhook_secret_key",
  "data": [
    {
      "entityType": "ProductPrice",
      "entityId": "019bfb55-bf56-7100-9dd5-7346a86d6353_24c7164d-050b-4891-908b-58e61fc58400",
      "entity": {
        "externalId": "420087",
        "priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
        "price": 249.00,
        "currencyId": "EUR"
      }
    },
    {
      "entityType": "ProductPrice",
      "entityId": "019bfb55-bf5b-7005-baef-8ade15664fce_24c7164d-050b-4891-908b-58e61fc58400",
      "entity": {
        "externalId": "409725",
        "priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
        "price": null,
        "currencyId": null
      }
    }
  ]
}

Field Descriptions

• secret — Shared secret key configured during setup. Your server must validate this string to ensure requests originate exclusively from Pricer24.
• data[] — Array of changed items:
• • entityType — Type of modified entity (currently ProductPrice)
  • entityId — Composite unique identifier in Pricer24
  • entity — Updated price object:
  • • externalId — Product identifier in your system (matches id from your catalog feed);
    • priceTypeId — Internal UUID of the price type in Pricer24;
    • price — New price value. If null, the price was cleared or removed;
    • currencyId — 3-letter currency code (UAH, EUR, USD) or null.

Security Best Practices

1. Use a secure HTTPS endpoint with a valid SSL/TLS certificate.
2. Validate the secret token immediately upon receiving the request:
3. • If the secret does not match, return 401 Unauthorized or 403 Forbidden.
   • If valid, append the payload to an asynchronous processing queue and immediately return 200 OK.

How to Connect a Webhook

1. Implement an endpoint on your server (e.g., https://api.myshop.com/webhooks/pricer24) that accepts POST requests matching the contract above.
2. Generate a secure secret string.
3. Provide your endpoint URL and secret key to your account manager or email support@pricer24.com.
4. We will execute a test call to confirm connectivity and activate the dispatcher.

Next Steps

• Learn how to set up automated pricing logic in Script Syntax
• If you prefer pulling prices on a fixed schedule instead of real-time push events, see Competitor Price Feed Specification or Working with the API

Updated on: 04/11/2026