PATCH webhooks/{id}¶

Update a webhook. Only the fields you send are changed. The secret can't be changed through the API and is not included in the response.

Endpoint¶

PATCH https://dropday.io/api/v1/webhooks/{id}

Path parameters¶

Parameter	Type	Description
id	Number	The ID of the webhook.

Parameters¶

Field	Type	Description
name `optional`	String	Max 255 characters.
description `optional`	String	Max 1000 characters.
url `optional`	String	Max 500 characters. Must be unique within your account.
events `optional`	String[]	One or more event names from GET webhooks/events. Replaces the current list.
active `optional`	Boolean	Set to `false` to pause deliveries.

Request¶

curl -X PATCH "https://dropday.io/api/v1/webhooks/12" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "api-key: tdh7nNUp3DZAHsMtw3dQYhDsm3wf593hMGbyXP6Y5R8DTF2Rwy4QCvkWFYQb" \
  -H "account-id: 101" \
  -d '{
    "events": ["supplier_order.created", "supplier_order.opened", "supplier_order.shipped"]
}'

Response¶

200422404403

{
    "data": {
        "id": 12,
        "name": "Magento",
        "description": "Installed by the Magento module",
        "url": "https://shop.example.com/dropday/webhook",
        "events": ["supplier_order.created", "supplier_order.opened", "supplier_order.shipped"],
        "active": true,
        "last_delivered_at": "2026-10-20T13:05:12.000000Z",
        "last_failed_at": null,
        "created_at": "2026-10-20T12:00:00.000000Z",
        "updated_at": "2026-10-20T14:10:00.000000Z"
    }
}

{
    "message": "The given data was invalid.",
    "errors": {
        "events": [
            "The events must have at least 1 items."
        ]
    }
}

{
    "message": "Webhook not found"
}

{
    "message": "Unauthorized."
}