Skip to main content
PATCH
Update a webhook

Path Parameters

id
string
required

Webhook ID

Query Parameters

projectId
string
required

Body

application/json
name
string

Webhook name for identification

Maximum string length: 255
Example:

"Player Events Webhook"

description
string

Description of the webhook purpose

Example:

"Sends player level-up events to our rewards service"

url
string

URL to deliver webhook payloads to

Maximum string length: 500
Example:

"https://api.yourapp.com/webhooks/engagefabric"

events
array[]

Event types to subscribe to

Example:
headers
object

Custom headers to include in webhook requests

Example:
isActive
boolean

Whether the webhook is active

Example:

true

maxConsecutiveFailures
number

Maximum consecutive failures before auto-disable (0 = never)

Example:

10

rateLimit
number

Rate limit in requests per hour (0 = unlimited)

Example:

1000

maxRetries
number

Maximum retry attempts for failed deliveries

Example:

3

retryDelaySeconds
number

Delay in seconds between retry attempts

Example:

60

resetFailures
boolean

Reset consecutive failure count

Example:

true

Response

200 - application/json
id
string
required
Example:

"wh_123abc"

projectId
string
required
Example:

"proj_456def"

name
string
required
Example:

"Player Events Webhook"

url
string
required
Example:

"https://api.yourapp.com/webhooks/engagefabric"

events
array[]
required
Example:
isActive
boolean
required
Example:

true

maxConsecutiveFailures
number
required
Example:

10

rateLimit
number
required
Example:

1000

maxRetries
number
required
Example:

3

retryDelaySeconds
number
required
Example:

60

consecutiveFailures
number
required
Example:

0

totalDeliveries
number
required
Example:

1500

successfulDeliveries
number
required
Example:

1480

failedDeliveries
number
required
Example:

20

createdAt
string
required
Example:

"2024-01-01T00:00:00Z"

updatedAt
string
required
Example:

"2024-01-15T10:30:00Z"

description
string
Example:

"Sends player level-up events to our rewards service"

headers
object
Example:
lastTriggeredAt
string
Example:

"2024-01-15T10:30:00Z"

lastSuccessAt
string
Example:

"2024-01-15T10:30:00Z"

lastFailureAt
string
Example:

"2024-01-14T08:00:00Z"