Webhooks

Endpointhttps://api.omnisocials.com/v1

Manage webhook subscriptions for real-time events.

List webhooks

GET

https://api.omnisocials.com/v1

/webhooks

List webhooks › Responses

200

List of webhooks

object[]

Create a webhook

POST

https://api.omnisocials.com/v1

/webhooks

Create a webhook › Request Body

url

string · uri · required

HTTPS URL to receive events

events

string[] · required

Enum values:

post.scheduled

post.published

post.failed

Create a webhook › Responses

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

object

message

string

Get webhook details

GET

https://api.omnisocials.com/v1

/webhooks/{id}

Get webhook details › path Parameters

id

string · required

Get webhook details › Responses

Webhook details

object

Delete a webhook

DELETE

https://api.omnisocials.com/v1

/webhooks/{id}

Delete a webhook › path Parameters

id

string · required

Delete a webhook › Responses

Webhook deleted

No data returned

Update a webhook

PATCH

https://api.omnisocials.com/v1

/webhooks/{id}

Update a webhook › path Parameters

id

string · required

Update a webhook › Request Body

url

string · uri

events

string[]

is_active

boolean

Update a webhook › Responses

Webhook updated

object

Rotate webhook secret

POST

https://api.omnisocials.com/v1

/webhooks/{id}/rotate-secret

Rotate webhook secret › path Parameters

id

string · required

Rotate webhook secret › Responses

New secret generated. Save it — it will only be shown once.

object

message

string

Analytics

Create a webhook

POST

https://api.omnisocials.com/v1

/webhooks

Create a webhook › Request Body

url

string · uri · required

HTTPS URL to receive events

events

string[] · required

Enum values:

post.scheduled

post.published

post.failed

Create a webhook › Responses

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

object

message

string