Skip to main content
POST
/
catalog
/
webhooks
const webhook = await lasso.catalog.webhooks.create({
  url: 'https://example.com/webhook',
  events: ['product.created', 'product.updated'],
  description: 'Sync to ERP',
});
// Store webhook.secret securely

{
  "id": "wh_abc123...",
  "url": "https://example.com/webhook",
  "events": ["product.created", "product.updated"],
  "secret": "whsec_a1b2c3d4e5f6...",
  "enabled": true,
  "description": "Sync to ERP",
  "created_at": "2026-05-27T10:00:00Z",
  "updated_at": "2026-05-27T10:00:00Z"
}
Create a webhook subscription to receive notifications when products are created, updated, or deleted. A signing secret is generated automatically and returned in the response.
​
url
string
required
The HTTPS endpoint URL that will receive webhook events.
​
events
array
required
Events to subscribe to. Valid values: product.created, product.updated, product.deleted.
​
description
string
Optional human-readable description for this webhook.
​
id
string
Unique webhook ID.
​
url
string
The endpoint URL.
​
events
array
Subscribed events.
​
secret
string
HMAC signing secret for verifying payloads. Only returned on creation.
​
enabled
boolean
Always true on creation.
​
created_at
string
ISO 8601 timestamp.
The secret is only returned once at creation time. Store it securely — you’ll need it to verify webhook signatures via the X-Lasso-Signature header.
const webhook = await lasso.catalog.webhooks.create({
  url: 'https://example.com/webhook',
  events: ['product.created', 'product.updated'],
  description: 'Sync to ERP',
});
// Store webhook.secret securely

{
  "id": "wh_abc123...",
  "url": "https://example.com/webhook",
  "events": ["product.created", "product.updated"],
  "secret": "whsec_a1b2c3d4e5f6...",
  "enabled": true,
  "description": "Sync to ERP",
  "created_at": "2026-05-27T10:00:00Z",
  "updated_at": "2026-05-27T10:00:00Z"
}