API reference · Webhooks

Update a webhook endpoint

Change the URL, subscribed events, filters, description, or enable/disable it.

PATCHhttps://fomodata.dev/v1/webhooks/{id}

Scopes:webhooks:writeRate class:standardFlag:WEBHOOKS_ENABLED

Example request

curl -X PATCH 'https://fomodata.dev/v1/webhooks/wh_8Tq3NkVz1LmB5xRc7pYd2F' \
  -H "Authorization: Bearer $FOMODATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Try it in the playground

Parameters

Path parameters

idstringrequired: e.g. wh_8Tq3NkVz1LmB5xRc7pYd2F

Request body

application/jsonUpdateWebhookRequest

urlstring
eventsarray<EventType>
filtersWebhookFilters & any+ 3 child attributes
- tokenarray<string>Token refs ($SYMBOL, address or tk_ id).
- handlearray<string>
- chainarray<string>
descriptionstring | null
statusenumRe-enabling a disabled_failing endpoint resets its failure streak."enabled""disabled"

Example bodyJSON

{}

Response

200 The updated webhook endpoint

application/jsonWebhook

objectenumrequired"webhook"
idstringrequired
urlstring (uri)required
descriptionstring | nullrequired
eventsarray<EventType>required
filtersobjectrequired+ 3 child attributes
- tokenarray<string>Token refs ($SYMBOL, address or tk_ id).
- handlearray<string>
- chainarray<string>
statusenumrequired"enabled""disabled""disabled_failing"
secret_prefixstringrequired
livemodebooleanrequired
created_atstring (date-time)required
updated_atstring (date-time)required

200 · exampleJSON

{
  "object": "webhook",
  "id": "wh_8Tq3NkVz1LmB5xRc7pYd2F",
  "url": "https://example.com",
  "description": "string",
  "events": [
    "thesis.created"
  ],
  "filters": {
    "token": [
      "string"
    ],
    "handle": [
      "string"
    ],
    "chain": [
      "string"
    ]
  },
  "status": "enabled",
  "secret_prefix": "whsec_Ab12",
  "livemode": true,
  "created_at": "2026-10-07T10:04:12.000Z",
  "updated_at": "2026-10-07T10:04:12.000Z"
}

Errors

Status	When
`400`	Bad request
`401`	Missing, invalid, revoked or expired API key
`403`	Insufficient scope, live access not approved, or history limit
`404`	Not found (or feature disabled)
`422`	Validation failed
`429`	Rate limit or quota exceeded

All errors use the standard envelope. See error codes for every code value.

← All endpoints openapi.json