Skip to main content

​
Overview

Feed webhooks notify your server when feed generation completes, fails, or validation finishes. Configure one or more webhook endpoints per workspace.

​
Webhook Events

EventTrigger
feed.generatedFeed generation completed successfully
feed.failedFeed generation failed
feed.validatedFeed validation check completed

​
Create a Subscription

POST /api/v1/feeds/{platform}/webhooks

curl -X POST "https://app.alana.shopping/api/v1/feeds/google/webhooks" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourserver.com/webhooks/alana",
    "events": ["feed.generated", "feed.failed"],
    "secret": "your_webhook_secret"
  }'

​
Webhook Payload

{
  "event": "feed.generated",
  "workspace_id": "ws_abc123",
  "platform": "google",
  "feed_url": "https://app.alana.shopping/api/v1/feeds/google",
  "product_count": 1432,
  "generated_at": "2026-03-17T12:00:00Z"
}

​
Verifying Signatures (HMAC-SHA256)

Every webhook request includes an X-Alana-Signature header. Verify it to confirm the request came from Alana: 
# Signature is sent in the X-Alana-Signature header
# X-Alana-Signature: sha256=abc123...

​
List Subscriptions

GET /api/v1/feeds/{platform}/webhooks

​
Delete a Subscription

DELETE /api/v1/feeds/{platform}/webhooks/{webhook_id}

​
Retry Policy

Alana retries failed webhook deliveries with exponential backoff: 1 min, 5 min, 30 min, 2 h, 8 h. After 5 failed attempts, the subscription is marked inactive and must be re-enabled manually. Respond with any 2xx status within 10 seconds to acknowledge receipt.
Last modified on March 18, 2026