Put v1webhooks

Create or update a webhook subscription for receiving event notifications.

Authentication: Requires Partner API Key (eve_pk_...). Company keys are not accepted.

Create: If no webhook exists, creates a new subscription and returns the signing secret. Store the secret securely — it cannot be retrieved again.

Update: If a webhook already exists, updates the URL and/or event types. The existing signing secret is preserved (not returned on update). Updating also re-activates a webhook that was automatically deactivated.

Event Types:

• document.processing.completed — Document processing finished successfully
• document.processing.failed — Document processing encountered an error

Webhook URL Requirements:

• Must be a valid HTTPS URL
• Must be publicly accessible
• Should respond with 2xx status within 10 seconds

Webhook Signing: All webhook deliveries include an X-EVE-Signature header containing an HMAC-SHA256 signature of the payload using your webhook secret.