Skip to main content
Server path: /brevo-ecommerce | Type: Application | PCID required: Yes

Tools

ToolDescription
brevo_ecommerce_create_batch_orderCreate orders in batch
brevo_ecommerce_create_coupon_collectionCreate а coupon collection
brevo_ecommerce_create_couponsCreate coupons for a coupon collection
brevo_ecommerce_create_ecommerce_activateActivate the eCommerce app
brevo_ecommerce_create_orderManaging the status of the order
brevo_ecommerce_create_payment_requestCreate a payment request
brevo_ecommerce_create_product_alertCreate a product alert for a contact
brevo_ecommerce_create_update_batch_categoryCreate categories in batch
brevo_ecommerce_create_update_batch_productsCreate products in batch
brevo_ecommerce_create_update_categoryCreate/Update a category
brevo_ecommerce_create_update_productCreate/Update a product
brevo_ecommerce_delete_payment_requestDelete a payment request.
brevo_ecommerce_get_attribution_metrics_by_conversion_source_by_conversion_source_idGet detailed attribution metrics for a single Brevo campaign or workflow
brevo_ecommerce_get_attribution_products_by_conversion_source_by_conversion_source_idGet attributed product sales for a single Brevo campaign or workflow
brevo_ecommerce_get_categoriesReturn all your categories
brevo_ecommerce_get_category_infoGet a category details
brevo_ecommerce_get_coupon_collectionGet a coupon collection by id
brevo_ecommerce_get_coupon_collectionsGet all your coupon collections
brevo_ecommerce_get_ordersGet order details
brevo_ecommerce_get_payment_requestGet payment request details
brevo_ecommerce_get_product_infoGet a product’s details
brevo_ecommerce_get_productsReturn all your products
brevo_ecommerce_list_ecommerce_attribution_metricsGet attribution metrics for one or more Brevo campaigns or workflows
brevo_ecommerce_list_ecommerce_config_display_currencyGet the ISO 4217 compliant display currency code for your Brevo account
brevo_ecommerce_set_config_display_currencySet the ISO 4217 compliant display currency code for your Brevo account
brevo_ecommerce_update_coupon_collectionUpdate a coupon collection by id

brevo_ecommerce_create_batch_order

Create orders in batch Parameters:
ParameterTypeRequiredDefaultDescription
historicalbooleanNoDefines whether you want your orders to be considered as live data or as historical data (import of past data, synchronising data). True: orders will not trigger any automation workflows. False: orders will trigger workflows as usual.
notifyUrlstringNoWebhook URL to receive the status of the batch request
ordersobject[]Yesarray of order objects

brevo_ecommerce_create_coupon_collection

Create а coupon collection Parameters:
ParameterTypeRequiredDefaultDescription
defaultCouponstringYesDefault coupons collection name
expirationDatestringNoSpecify an expiration date for the coupon collection in RFC3339 format. Use null to remove the expiration date.
namestringYesName of the coupons collection
remainingCouponsAlertintegerNoSend a notification alert (email) when the remaining coupons count is equal or fall bellow this number. Use null to disable alerts.
remainingDaysAlertintegerNoSend a notification alert (email) when the remaining days until the expiration date are equal or fall bellow this number. Use null to disable alerts.

brevo_ecommerce_create_coupons

Create coupons for a coupon collection Parameters:
ParameterTypeRequiredDefaultDescription
collectionIdstringYesThe id of the coupon collection for which the coupons will be created
couponsstring[]YesThe coupons value

brevo_ecommerce_create_ecommerce_activate

Activate the eCommerce app

brevo_ecommerce_create_order

Managing the status of the order Parameters:
ParameterTypeRequiredDefaultDescription
amountnumberYesTotal amount of the order, including all shipping expenses, tax and the price of items.
billingobjectNoBilling details of an order.
couponsstring[]NoCoupons applied to the order. Stored case insensitive.
createdAtstringYesEvent occurrence UTC date-time (YYYY-MM-DDTHH:mm:ssZ), when order is actually created.
idstringYesUnique ID of the order.
identifiersobjectNoIdentifies the contact associated with the order.
metaInfoobjectNoMeta data of order to store additional detail such as custom message, customer type, source.
productsobject[]YesThe products value
statusstringYesState of the order.
storeIdstringNoID of store where the order is placed
updatedAtstringYesEvent updated UTC date-time (YYYY-MM-DDTHH:mm:ssZ), when the status of the order is actually changed/updated.

brevo_ecommerce_create_payment_request

Create a payment request Parameters:
ParameterTypeRequiredDefaultDescription
cartobjectYesSpecify the payment currency and amount.
configurationobjectNoOptional. Redirect contact to a custom success page once payment is successful. If empty the default Brevo page will be displayed once a payment is validated
contactIdintegerYesBrevo ID of the contact requested to pay.
descriptionstringNoDescription of payment request.
notificationobjectNoOptional. Use this object if you want to let Brevo send an email to the contact, with the payment request URL. If empty, no notifications (message and reminders) will be sent.
referencestringYesReference of the payment request, it will appear on the payment page.

brevo_ecommerce_create_product_alert

Create a product alert for a contact Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesProduct ID
typestringYesAlert type
contactIdentifiersobjectNoContact Identifiers

brevo_ecommerce_create_update_batch_category

Create categories in batch Parameters:
ParameterTypeRequiredDefaultDescription
categoriesobject[]Yesarray of categories objects
updateEnabledbooleanNoFacilitate to update the existing categories in the same request (updateEnabled = true)

brevo_ecommerce_create_update_batch_products

Create products in batch Parameters:
ParameterTypeRequiredDefaultDescription
productsobject[]Yesarray of products objects
updateEnabledbooleanNoFacilitate to update the existing products in the same request (updateEnabled = true)

brevo_ecommerce_create_update_category

Create/Update a category Parameters:
ParameterTypeRequiredDefaultDescription
deletedAtstringNoUTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of the category deleted from the shop’s database
idstringYesUnique Category ID as saved in the shop
isDeletedbooleanNocategory deleted from the shop’s database
namestringNoMandatory in case of creation. Name of the Category, as displayed in the shop
updateEnabledbooleanNoFacilitate to update the existing category in the same request (updateEnabled = true)
urlstringNoURL to the category

brevo_ecommerce_create_update_product

Create/Update a product Parameters:
ParameterTypeRequiredDefaultDescription
alternativePricenumberNoAlternative price of the product
brandstringNoBrand of the product
categoriesstring[]NoCategory ID-s of the product
deletedAtstringNoUTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of the product deleted from the shop’s database
descriptionstringNoDescription of the product
idstringYesProduct ID for which you requested the details
imageUrlstringNoAbsolute URL to the cover image of the product
isDeletedbooleanNoproduct deleted from the shop’s database
metaInfoobjectNoMeta data of product such as description, vendor, producer, stock level. The total characters of cumulative metaInfo shall not exceed 20000 characters.
namestringYesMandatory in case of creation. Name of the product, as displayed in the shop
parentIdstringNoParent product id of the product
pricenumberNoPrice of the product
skustringNoProduct identifier from the shop
stocknumberNoCurrent stock value of the product from the shop’s database
updateEnabledbooleanNoFacilitate to update the existing product in the same request (updateEnabled = true)
urlstringNoURL to the product

brevo_ecommerce_delete_payment_request

Delete a payment request. Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the payment request.

brevo_ecommerce_get_attribution_metrics_by_conversion_source_by_conversion_source_id

Get detailed attribution metrics for a single Brevo campaign or workflow Parameters:
ParameterTypeRequiredDefaultDescription
conversionSourcestringYesThe Brevo campaign type or workflow type for which data will be retrieved
conversionSourceIdstringYesThe Brevo campaign or automation workflow id for which data will be retrieved

brevo_ecommerce_get_attribution_products_by_conversion_source_by_conversion_source_id

Get attributed product sales for a single Brevo campaign or workflow Parameters:
ParameterTypeRequiredDefaultDescription
conversionSourcestringYesThe Brevo campaign or automation workflow type for which data will be retrieved
conversionSourceIdstringYesThe Brevo campaign or automation workflow id for which data will be retrieved

brevo_ecommerce_get_categories

Return all your categories Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
idsstring[]NoFilter by category ids
namestringNoFilter by category name
modifiedSincestringNoFilter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
createdSincestringNoFilter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
isDeletedstringNoFilter categories by their deletion status. If false is passed, only categories that are not deleted will be returned.

brevo_ecommerce_get_category_info

Get a category details Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesCategory ID

brevo_ecommerce_get_coupon_collection

Get a coupon collection by id Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesId of the collection to return

brevo_ecommerce_get_coupon_collections

Get all your coupon collections Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document on the page
sortstringNoSort the results by creation time in ascending/descending order
sortBystringNoThe field used to sort coupon collections

brevo_ecommerce_get_orders

Get order details Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
modifiedSincestringNoFilter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
createdSincestringNoFilter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

brevo_ecommerce_get_payment_request

Get payment request details Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesId of the payment Request

brevo_ecommerce_get_product_info

Get a product’s details Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesProduct ID

brevo_ecommerce_get_products

Return all your products Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
idsstring[]NoFilter by product ids
searchstringNoSearch products simultaneously across SKU, name, and ID fields. Results are returned in the following priority order: exact SKU match > SKU prefix match > name match > ID match. For example, ?search=123 on products with {sku: "123"} and {sku: "123456"} returns the exact SKU match first.
namestringNoFilter by product name, minimum 3 characters should be present for search.
price[lte]numberNoPrice filter for products less than and equals to particular amount
price[gte]numberNoPrice filter for products greater than and equals to particular amount
price[lt]numberNoPrice filter for products less than particular amount
price[gt]numberNoPrice filter for products greater than particular amount
price[eq]numberNoPrice filter for products equals to particular amount
price[ne]numberNoPrice filter for products not equals to particular amount
alternativePrice[lte]numberNoAlternative price filter for products less than and equals to particular amount
alternativePrice[gte]numberNoAlternative price filter for products greater than and equals to particular amount
alternativePrice[lt]numberNoAlternative price filter for products less than particular amount
alternativePrice[gt]numberNoAlternative price filter for products greater than particular amount
alternativePrice[eq]numberNoAlternative price filter for products equals to particular amount
alternativePrice[ne]numberNoAlternative price filter for products not equals to particular amount
categoriesstring[]NoFilter by categories ids
modifiedSincestringNoFilter (urlencoded) the products modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
createdSincestringNoFilter (urlencoded) the products created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
sortByFieldstringNoSort the results by a specific field. Default sort field is created_at when not passed.
isDeletedstringNoFilter products by their deletion status. If false is passed, only products that are not deleted will be returned.

brevo_ecommerce_list_ecommerce_attribution_metrics

Get attribution metrics for one or more Brevo campaigns or workflows Parameters:
ParameterTypeRequiredDefaultDescription
periodFromstringNoWhen getting metrics for a specific period, define the starting datetime in RFC3339 format
periodTostringNoWhen getting metrics for a specific period, define the end datetime in RFC3339 format
emailCampaignId[]string[]NoThe email campaign ID(s) to get metrics for
smsCampaignId[]string[]NoThe SMS campaign ID(s) to get metrics for
automationWorkflowEmailId[]string[]NoThe automation workflow ID(s) to get email attribution metrics for
automationWorkflowSmsId[]string[]NoThe automation workflow ID(s) to get SMS attribution metrics for

brevo_ecommerce_list_ecommerce_config_display_currency

Get the ISO 4217 compliant display currency code for your Brevo account

brevo_ecommerce_set_config_display_currency

Set the ISO 4217 compliant display currency code for your Brevo account Parameters:
ParameterTypeRequiredDefaultDescription
codestringYesISO 4217 compliant display currency code

brevo_ecommerce_update_coupon_collection

Update a coupon collection by id Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesId of the collection to update
defaultCouponstringNoA default coupon to be used in case there are no coupons left
expirationDatestringNoSpecify an expiration date for the coupon collection in RFC3339 format. Use null to remove the expiration date.
remainingCouponsAlertintegerNoSend a notification alert (email) when the remaining coupons count is equal or fall bellow this number. Use null to disable alerts.
remainingDaysAlertintegerNoSend a notification alert (email) when the remaining days until the expiration date are equal or fall bellow this number. Use null to disable alerts.