Webhooks

Receive real-time notifications when events happen in your marketplace. Connect to external systems like Zapier, Make, or your own backend.

What are Webhooks?

Webhooks are automated messages sent from your marketplace to external systems when specific events occur. Think of them as real-time notifications that let other applications know something happened.

Event Occurs

New order placed

→

Webhook Fires

HTTP POST request

→

Your System

Processes data

Common Use Cases

Inventory Management

Sync orders to your inventory system when purchases are made.

Custom Notifications

Send alerts to Slack, Discord, or email when events occur.

Automation Platforms

Trigger workflows in Zapier, Make (Integromat), or n8n.

CRM Updates

Update your CRM when new sellers register or orders complete.

Analytics Dashboards

Build custom analytics by streaming events to your data warehouse.

Fulfillment Systems

Automatically trigger shipping and fulfillment workflows.

Available Events

Subscribe to any combination of these events when creating a webhook endpoint:

Event	Triggered When
order.created	A new order is placed
order.completed	An order is marked complete
order.canceled	An order is canceled
listing.created	A new listing is published
listing.updated	A listing is modified
listing.deleted	A listing is removed
seller.registered	A new seller signs up
seller.approved	A seller is approved
message.received	A new message is sent
review.created	A review is submitted
booking.requested	A booking is requested
booking.confirmed	A booking is confirmed

Creating a Webhook Endpoint

Follow these steps to set up a webhook endpoint:

Go to Store Settings → Webhooks

Click "Add Endpoint"

Enter your endpoint URL (must be HTTPS)

https://your-server.com/webhook/prometora

Select the events you want to receive

Click "Create Endpoint" to save

Copy the signing secret for verification

Webhook Security

Each webhook endpoint receives a unique signing secret. Use this to verify that incoming requests are genuinely from Prometora and haven't been tampered with.

Signing Secret

whsec_abc123def456...

Store this secret securely. Never expose it in client-side code.

Security Best Practice

Always verify the webhook signature in your endpoint before processing the data. This prevents attackers from sending fake events to your system.

Webhook Payload

Webhook requests are sent as HTTP POST with a JSON body:

{
  "id": "evt_abc123",
  "type": "order.created",
  "created": "2026-01-04T12:00:00Z",
  "data": {
    "id": "ord_xyz789",
    "total": 9999,
    "currency": "usd",
    "customer": {
      "email": "[email protected]",
      "name": "John Doe"
    },
    "items": [
      {
        "listing_id": "lst_123",
        "title": "Handmade Pottery",
        "quantity": 1,
        "price": 9999
      }
    ]
  }
}

Managing Webhooks

Enable/Disable

Toggle webhooks on or off without deleting them. Disabled webhooks won't receive any events.

View Activity

Each webhook shows when it was last triggered, helping you verify it's working correctly.

Delete

Remove webhook endpoints you no longer need. This action cannot be undone.

Integration Examples

Zapier

Use Zapier's "Webhooks by Zapier" trigger to catch Prometora events and connect to 5,000+ apps.

Learn more about Zapier Webhooks

Make (Integromat)

Create a "Custom Webhook" module in Make to receive Prometora events and build complex automations.

Learn more about Make Webhooks

Slack Notifications

Send order and seller notifications directly to Slack channels using Slack's Incoming Webhooks or via Zapier/Make.

Pro Tips

Start with a test endpoint (like webhook.site) to see the payload structure
Your endpoint should respond with a 200 status within 30 seconds
Process webhooks asynchronously to avoid timeouts
Implement idempotency to handle duplicate deliveries gracefully

Business Plan Feature