Webhooks

Subscribe to events for real-time notifications when posts are published, fail, or are scheduled.

Creating a Webhook

Code
curl -X POST https://api.omnisocials.com/v1/webhooks \
  -H "Authorization: Bearer omsk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhook",
    "events": ["post.published", "post.failed"]
  }'

Verifying Webhooks

Webhook payloads are signed with HMAC-SHA256. Verify using the secret provided when creating the webhook.

The signature is included in the X-Webhook-Signature header.

Managing Webhooks

• GET /webhooks - List all webhooks
• GET /webhooks/:id - Get a specific webhook
• PUT /webhooks/:id - Update a webhook
• DELETE /webhooks/:id - Delete a webhook
• POST /webhooks/:id/rotate-secret - Rotate the signing secret