![Bluestone_PIM_white_logo_RBB-3.png]](https://help.bluestonepim.com/hs-fs/hubfs/Bluestone_PIM_white_logo_RBB-3.png?height=50&name=Bluestone_PIM_white_logo_RBB-3.png){kind=logo}
You need to be given explicit permission to manage webhooks.
Managed roles having this permission: System Admin and PIM Admin.
Overview
Add a webhook Edit a webhook Delete a webhook
Webhook event types
Product updates Catalog/category updates Asset updates Other updates
Overview
Integrate Bluestone PIM with your external systems using webhooks. Once configured, the PIM will automatically post notifications for selected events to your designated URL.
Select Settings | Webhooks from the main navigation bar to get an overview and manage your webhooks.
You can easily enable/disable a webhook directly from the grid by using the toggle in the Enabled column.
Add a webhook
- Click the plus icon (Add new webhook) in the upper right corner. The following page is presented:
- Input the Webhook URL.
Tip! Use http://webhook.site/ with your organization URL.
- Add the Secret key as a password.
- Select the Status. If you keep the webhook Enabled, it will start receiving notifications immediately after saving.
- Select the update notifications you want to receive. Please refer to Webhook types for details.
- Click Save when you are done.
Edit a webhook
To make changes to an existing webhook configuration, hover the relevant webhook from the grid and select Edit from the 3-dots menu:
Edit according to your needs and click Save when you are done. Please refer to Add a webhook for more information.
Delete a webhook
To remove a webhook configuration, hover the relevant webhook from the grid and select Delete from the 3-dots menu:
Click Delete in the pop-up to confirm removal.
Webhook event types
The different update events are categorized into sections. You can collapse/expand the sections to find the relevant events more easily.
Please refer to Webhook event reference for details on the contents of each notification.
Product updates
- Product created
- Product name changed
- Product number changed
- Product description changed
- Product status changed
- Product category changed (added, removed)
- Product assets changed (assigned, unassigned)
- Product relation changed (assigned, unassigned)
- Product label changed (added, removed)
- Attribute assigned to product
- Attribute unassigned from product
- Attribute value changed on product
VARIANT GROUPS AND BUNDLES:
- Product added or removed from variant group
- Product added or removed from bundle
- Product quantity in bundle changed
Catalog and category updates
- Catalog/category added
- Catalog/category name changed
- Catalog/category number changed
- Catalog/category description changed
- Catalog/category asset changed
- Category moved to different parent category
- Category reordered within parent catalog
- Category deleted
- Catalog archived
- Attribute assigned to catalog/category
- Attribute unassigned from catalog/category
- Attribute value changed on catalog/category
- Category level attribute (CLA) value changed
Asset updates
- Asset added
- Asset name changed
- Asset number changed
- Asset description changed
- Attribute assigned to asset
- Attribute unassigned from asset
- Attribute value changed on asset
Other updates
- New sync done
- Plugin data changed