Skip to main content
PATCH
/
webhooks
/
{id}
Update webhook endpoint
curl --request PATCH \
  --url https://api.social-api.ai/v1/webhooks/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [],
  "is_active": true,
  "url": "https://example.com/webhooks/socialapi"
}
'
{
  "created_at": "2026-03-14T09:00:00Z",
  "events": [
    "comment.received",
    "dm.received"
  ],
  "id": "wh_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "is_active": true,
  "url": "https://example.com/webhooks/socialapi"
}

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Path Parameters

​
id
string
required

Webhook endpoint ID

Body

application/json

Fields to update

​
events
enum<string>[]

Events replaces the subscribed event types.

Available options:
comment.received,
dm.received,
review.received,
mention.received
​
is_active
boolean

IsActive enables or disables delivery to this endpoint.

Example:

true

​
url
string

URL changes the webhook delivery endpoint. Must be HTTPS.

Example:

"https://example.com/webhooks/socialapi"

Response

OK

​
created_at
string
Example:

"2026-03-14T09:00:00Z"

​
events
string[]
Example:
["comment.received", "dm.received"]
​
id
string
Example:

"wh_01HZ9X3Q4R5M6N7P8V2K0W1J"

​
is_active
boolean
Example:

true

​
url
string
Example:

"https://example.com/webhooks/socialapi"