Webhook Events
Complete reference of all webhook event types fired by Crove.
Webhook Events
Crove fires webhook events across the full document lifecycle. Subscribe to specific events when configuring your outgoing webhooks.
Document events
Events related to the document lifecycle.
document.created
Fired when a new document is created from a template.
{
"event": "document.created",
"documentId": "doc_abc123",
"templateId": "tmpl_xyz789",
"timestamp": "2026-02-18T10:00:00Z",
"data": {
"documentName": "Contract - Acme Corp",
"createdBy": "user@company.com"
}
}document.updated
Fired when a document's response data or metadata is updated.
{
"event": "document.updated",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T10:30:00Z",
"data": {
"documentName": "Contract - Acme Corp",
"updatedFields": ["clientName", "contractAmount"]
}
}document.completed
Fired when all respondents have submitted their responses and signatures. This is typically the most important event to subscribe to.
{
"event": "document.completed",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T14:00:00Z",
"data": {
"documentName": "Contract - Acme Corp",
"responseData": {
"clientName": "Acme Corporation",
"contractAmount": 50000,
"startDate": "2026-03-01"
},
"completedAt": "2026-02-18T14:00:00Z"
}
}document.deleted
Fired when a document is permanently deleted.
{
"event": "document.deleted",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T15:00:00Z",
"data": {
"documentName": "Contract - Acme Corp"
}
}document.viewed
Fired when a document is opened by a recipient.
{
"event": "document.viewed",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T11:00:00Z",
"data": {
"viewedBy": "john@acme.com"
}
}document.pdf_generated
Fired when a PDF is generated for the document.
{
"event": "document.pdf_generated",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T14:05:00Z",
"data": {
"documentName": "Contract - Acme Corp"
}
}document.pdf_downloaded
Fired when someone downloads the document PDF.
{
"event": "document.pdf_downloaded",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T14:10:00Z",
"data": {
"downloadedBy": "user@company.com"
}
}Respondent events
Events related to document recipients.
respondent.invited
Fired when an invitation is sent to a respondent.
{
"event": "respondent.invited",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T10:15:00Z",
"data": {
"respondentEmail": "john@acme.com",
"role": "Client"
}
}respondent.viewed
Fired when a respondent opens the fill page for the first time.
{
"event": "respondent.viewed",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T11:00:00Z",
"data": {
"respondentEmail": "john@acme.com"
}
}respondent.submitted
Fired when a respondent submits their form response.
{
"event": "respondent.submitted",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:00:00Z",
"data": {
"respondentEmail": "john@acme.com",
"role": "Client",
"responseData": {
"clientName": "Acme Corporation",
"contractAmount": 50000
}
}
}respondent.expired
Fired when a respondent's invitation expires.
{
"event": "respondent.expired",
"documentId": "doc_abc123",
"timestamp": "2026-02-25T10:15:00Z",
"data": {
"respondentEmail": "john@acme.com"
}
}Signature events
Events related to e-signatures.
signature.requested
Fired when a signature is requested from a respondent.
{
"event": "signature.requested",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:00:00Z",
"data": {
"signerEmail": "john@acme.com",
"role": "Client"
}
}signature.otp_sent
Fired when an OTP is sent for signature verification.
{
"event": "signature.otp_sent",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:01:00Z",
"data": {
"signerEmail": "john@acme.com"
}
}signature.otp_verified
Fired when an OTP is successfully verified.
{
"event": "signature.otp_verified",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:02:00Z",
"data": {
"signerEmail": "john@acme.com"
}
}signature.signed
Fired when a respondent successfully signs the document.
{
"event": "signature.signed",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:05:00Z",
"data": {
"signerEmail": "john@acme.com",
"signatureType": "draw",
"consentGiven": true
}
}signature.declined
Fired when a respondent declines to sign.
{
"event": "signature.declined",
"documentId": "doc_abc123",
"timestamp": "2026-02-18T12:05:00Z",
"data": {
"signerEmail": "john@acme.com",
"reason": "Terms not acceptable"
}
}Webhook delivery events
Meta-events about webhook delivery itself.
webhook.fired
Logged when a webhook payload is sent to your endpoint.
webhook.failed
Logged when all retry attempts for a webhook delivery have failed.
Event summary
| Event | Trigger |
|---|---|
document.created | Document created from template |
document.updated | Document data modified |
document.completed | All respondents finished |
document.deleted | Document permanently deleted |
document.viewed | Document opened by recipient |
document.pdf_generated | PDF created for document |
document.pdf_downloaded | PDF downloaded |
respondent.invited | Invitation email sent |
respondent.viewed | Fill page first opened |
respondent.submitted | Form response submitted |
respondent.expired | Invitation expired |
signature.requested | Signature requested |
signature.otp_sent | OTP sent for verification |
signature.otp_verified | OTP verified successfully |
signature.signed | Document signed |
signature.declined | Signature declined |