For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
  • Sales CRM
  • Conversations
  • Ecommerce
      • POSTCreate/Update a product
      • GETGet a product's details
      • POSTCreate products in batch
      • GETReturn all your products
      • POSTCreate a product alert for a contact
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
EcommerceProducts

Create a product alert for a contact

POST
https://api.brevo.com/v3/products/:id/alerts/:type
POST
/v3/products/:id/alerts/:type
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4 const client = new BrevoClient({
5 apiKey: "YOUR_API_KEY_HERE",
6 });
7 await client.ecommerce.createProductAlert("id", "back_in_stock", {});
8}
9main();
Register a contact to receive an alert for a specific product event, such as `back_in_stock`. At least one contact identifier (`ext_id`, `email`, or `sms`) must be provided; when multiple are given, priority is `ext_id` > `email` > `sms`. Returns a `404` error if the product ID does not exist, and a `403` error if product alerts are not enabled for the account.
Was this page helpful?
Previous

Return all your categories

Next
Built with

Register a contact to receive an alert for a specific product event, such as back_in_stock. At least one contact identifier (ext_id, email, or sms) must be provided; when multiple are given, priority is ext_id > email > sms. Returns a 404 error if the product ID does not exist, and a 403 error if product alerts are not enabled for the account.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Path parameters

idstringRequired
Product ID
typeenumRequired
Alert type
Allowed values:

Request

Contact identifier to associate the alert with (at least one is required). Priority is given to ext_id > email > sms

contactIdentifiersobjectOptional

Response

Product alert was created

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error