Webhook Events

inSigner dispatches 17 event types across 4 categories. You can subscribe to specific events or use "*" to receive all events.

Event types

Event	Description
`document.created`	A document was created
`document.sent`	A document was sent for signing
`document.signed`	All required signers have signed (alias for completed)
`document.completed`	Document signing is fully completed
`document.declined`	A signer declined the document
`document.expired`	Document reached its expiration date
`document.cancelled`	Document was cancelled by the sender
`signer.completed`	An individual signer completed their signing
`signer.declined`	An individual signer declined to sign
`signer.viewed`	A signer opened the signing link
`signer.kyc_completed`	Signer passed KYC verification
`signer.kyc_failed`	Signer failed KYC verification
`campaign.created`	A campaign was created
`campaign.submission`	Someone submitted a campaign form
`campaign.closed`	A campaign was closed
`bulk_send.completed`	A bulk send job completed
`bulk_send.failed`	A bulk send job failed

Document events

document.created

Fired when a document is created via the API or from a template.

{
  "id": "d3f1a2b4c5e6...",
  "event": "document.created",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T12:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "status": "draft",
    "created_by": "usr_abc123",
    "template_id": null
  }
}

document.sent

Fired when a document is sent for signing. Includes signer details.

{
  "id": "a8c2d4e6f0b1...",
  "event": "document.sent",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T12:05:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "signer_count": 2,
    "signers": [
      { "email": "[email protected]", "name": "Jane Smith" },
      { "email": "[email protected]", "name": "John Doe" }
    ],
    "sent_at": "2026-05-28T12:05:00.000Z"
  }
}

document.completed

Fired when all signers have completed signing.

{
  "id": "f7e6d5c4b3a2...",
  "event": "document.completed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T14:30:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "status": "completed",
    "completed_at": "2026-05-29T14:30:00.000Z",
    "signer_count": 2,
    "signers": [
      { "email": "[email protected]", "name": "Jane Smith", "signed_at": "2026-05-29T10:00:00.000Z" },
      { "email": "[email protected]", "name": "John Doe", "signed_at": "2026-05-29T14:30:00.000Z" }
    ]
  }
}

document.declined

Fired when a signer declines the document.

{
  "id": "b1a2c3d4e5f6...",
  "event": "document.declined",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T11:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "status": "declined",
    "declined_by": {
      "email": "[email protected]",
      "name": "Jane Smith"
    },
    "decline_reason": "Terms not acceptable"
  }
}

document.expired

Fired when a document reaches its expiration date without being completed.

{
  "id": "c2d3e4f5a6b7...",
  "event": "document.expired",
  "api_version": "2026-05-28",
  "created_at": "2026-11-28T12:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "status": "expired",
    "expired_at": "2026-11-28T12:00:00.000Z",
    "pending_signers": 1
  }
}

document.cancelled

Fired when a document is cancelled by the sender.

{
  "id": "e4f5a6b7c8d9...",
  "event": "document.cancelled",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T16:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "status": "cancelled",
    "cancelled_by": "usr_abc123",
    "cancelled_signers": 2
  }
}

Signer events

signer.completed

Fired when an individual signer completes their signing (the document may still have other pending signers).

{
  "id": "a6b7c8d9e0f1...",
  "event": "signer.completed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T10:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "signer": {
      "id": "sr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith",
      "role": "signer",
      "signed_at": "2026-05-29T10:00:00.000Z"
    },
    "remaining_signers": 1
  }
}

signer.declined

{
  "id": "b7c8d9e0f1a2...",
  "event": "signer.declined",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T11:00:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "signer": {
      "id": "sr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith",
      "role": "signer"
    },
    "reason": "Terms not acceptable"
  }
}

signer.viewed

Fired when a signer opens the signing link for the first time.

{
  "id": "c8d9e0f1a2b3...",
  "event": "signer.viewed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T09:30:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "document_name": "Sales Agreement Q3",
    "signer": {
      "id": "sr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith"
    },
    "viewed_at": "2026-05-29T09:30:00.000Z"
  }
}

signer.kyc_completed

Fired when a signer passes KYC (identity verification).

{
  "id": "d9e0f1a2b3c4...",
  "event": "signer.kyc_completed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T09:45:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "signer": {
      "id": "sr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith"
    },
    "kyc_status": "passed",
    "verified_at": "2026-05-29T09:45:00.000Z"
  }
}

signer.kyc_failed

{
  "id": "e0f1a2b3c4d5...",
  "event": "signer.kyc_failed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-29T09:45:00.000Z",
  "data": {
    "document_id": "cm5x9abc123",
    "signer": {
      "id": "sr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith"
    },
    "kyc_status": "failed",
    "reason": "Document verification failed"
  }
}

Campaign events

campaign.created

{
  "id": "f1a2b3c4d5e6...",
  "event": "campaign.created",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T12:00:00.000Z",
  "data": {
    "campaign_id": "cmp_abc123",
    "campaign_name": "Employee Onboarding NDA",
    "slug": "employee-onboarding-nda-a1b2c3d4",
    "template_id": "tpl_abc123"
  }
}

campaign.submission

Fired when someone submits a completed form through a campaign.

{
  "id": "a2b3c4d5e6f7...",
  "event": "campaign.submission",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T15:30:00.000Z",
  "data": {
    "campaign_id": "cmp_abc123",
    "campaign_name": "Employee Onboarding NDA",
    "document_id": "cm5x9jkl012",
    "signer": {
      "name": "Carlos Rodriguez",
      "email": "[email protected]"
    },
    "submission_number": 143
  }
}

campaign.closed

{
  "id": "b3c4d5e6f7a8...",
  "event": "campaign.closed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-30T10:00:00.000Z",
  "data": {
    "campaign_id": "cmp_abc123",
    "campaign_name": "Employee Onboarding NDA",
    "total_submissions": 150,
    "closed_reason": "max_submissions_reached"
  }
}

Bulk send events

bulk_send.completed

{
  "id": "c4d5e6f7a8b9...",
  "event": "bulk_send.completed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T10:05:00.000Z",
  "data": {
    "bulk_send_id": "bs_abc123",
    "bulk_send_name": "Q3 Vendor Agreements",
    "total_count": 150,
    "sent_count": 148,
    "failed_count": 2,
    "template_id": "tpl_abc123"
  }
}

bulk_send.failed

{
  "id": "d5e6f7a8b9c0...",
  "event": "bulk_send.failed",
  "api_version": "2026-05-28",
  "created_at": "2026-05-28T10:05:00.000Z",
  "data": {
    "bulk_send_id": "bs_def456",
    "bulk_send_name": "Failed Batch",
    "total_count": 50,
    "sent_count": 0,
    "failed_count": 50,
    "error": "Template file not found"
  }
}