Skip to content

Webhook events

Each delivery uses the { event, data } envelope from Outbound delivery. This page lists event names and what you should expect under data for documents and templates.

Document payloads usually include a document object with public id, title, status, timestamps, and metadata. Other fields (such as signers, recipients, or account) appear when they apply to that event.

Document events (document.*)

EventSummary
document.createdPayload includes document, created_by, optional account.
document.updateddocument, updated_by, optional account.
document.out_for_signaturedocument, sent_by, recipients.
document.waiting_on_medocument, sent_by, recipients.
document.completeddocument, optional completed_by, signers.
document.declineddocument, declined_by, optional declined_at, decline_reason.
document.voideddocument, voided_by, voided_at, optional reason.
document.expireddocument.
document.failed_deliverydocument, recipient, failed_at, optional failure_reason, error_code.
document.deleteddocument, deleted_by, deleted_at.

Template events (template.*)

EventSummary
template.createdtemplate, created_by.
template.updatedtemplate, updated_by, optional changes.
template.deletedtemplate, deleted_by, deleted_at.

Which subscriptions receive an event

When you register a webhook, you choose a subscription type (for example, events about documents). Upsign delivers each event only to subscriptions whose type matches that event family—document.* events go to document-type subscriptions, template.* to template-type subscriptions, and so on. Traffic is always scoped to your company, so you only see activity for your tenant.