OMomnisocials
Webhooks

Create a webhook

Changed on
post/webhooks

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/webhooks
  • Auth
    HTTP bearer

Request body

urlstring uri required

HTTPS URL to receive events. Must resolve to a public host; private, loopback, link-local and unresolvable hosts are rejected with validation_error.

eventsstring[] required

Example request

{
  "url": "https://example.com/webhooks/omnisocials"
}

Response

Webhook created. The secret is only returned once at creation.

messagestring

Example response

{
  "data": {
    "id": "74327072-ec54-473c-837f-63b29187ac16",
    "url": "https://example.com/webhooks/omnisocials",
    "is_active": true,
    "last_triggered_at": "2026-10-21T09:00:07.000Z",
    "last_failure": {
      "at": "2026-10-18T07:42:31.000Z",
      "status": 404,
      "error": "Endpoint responded with HTTP 404",
      "attempts": 4
    },
    "created_at": "2026-09-30T12:00:00.000Z",
    "secret": "159ba257854f3f71a9b363b04367862705c72e3ed4cd746ecc11274f5c88291e"
  },
  "message": "Webhook created. Save the secret - it will only be shown once. Use it to verify webhook signatures."
}

Changes

  • d28eab4dda4eRevision changes
    • warning

      added the new post.approved enum value to the ////// response property for the response status

    • warning

      added the new post.rejected enum value to the ////// response property for the response status

    • info

      added the new post.approved enum value to the request property /

    • info

      added the new post.rejected enum value to the request property /