Get webhook event sample

GET/api/v1/triggers/{event}/sample

This endpoint isn’t available for live testing.

curl 'https://app.quote.cloud/api/v1/triggers/{event}/sample?client_id=<your client id>' \
  -H 'Authorization: Bearer <your token>'

<your token> and <your client id> are placeholders. Get your own

Inputs

eventrequiredThe webhook event to get a sample payload for.

client_idrequiredYou don’t need to enter this here. In your own code, use the Client ID from your OAuth client. How to get one

statusDocument status for documentStatusChange; optional subtype for delivery (scheduled, paused_addon, queued, preparing, sending, sent, skipped, failed, needs_review, cancelled), product (created, updated, activated, deactivated), payment (received, failed, refunded), or comment (created, resolved, reopened).

Not sure what to enter? Here’s where to find IDs

Example response

[
  {
    "id": "string",
    "event": "form_submission",
    "submissionId": "string",
    "documentId": "string",
    "recipientId": "string",
    "submittedAt": "2026-01-31T09:30:00Z",
    "valueCount": 0,
    "formSubmission": {
      "id": "string",
      "submissionId": "string",
      "documentId": "string",
      "recipientId": "string",
      "submitterName": "string",
      "submitterEmail": "string",
      "submittedAt": "2026-01-31T09:30:00Z",
      "answerCount": 0,
      "answersTruncated": true,
      "fieldDefinitionsTruncated": true,
      "answers": [
        {
          "answerId": "string",
          "fieldId": "string",
          "fieldKey": "string",
          "fieldLabel": "string",
          "fieldType": "string",
          "fieldDefinitionFound": true,
          "blockId": "string",
          "repeaterBlockId": "string",
          "entryId": "string",
          "privateToAssignee": true,
          "value": "string",
          "valueJson": "string",
          "valueType": "text"
        }
      ]
    }
  }
]

The spec has no example, so this 200 response is generated from the schema. Values are placeholders.

Get a sample payload for a domain-event webhook

The required OAuth scope depends on event; see TriggerEvent.

Permission

An OAuth access token with any one of these scopes. How to get a token

webhooks:form_submission

Subscribe to form submissions.

webhooks:contact_created

Subscribe to contact creation.

webhooks:document_created

Subscribe to document creation.

webhooks:recipient_activity

Subscribe to recipient views and signatures.

webhooks:contact_changes

Subscribe to contact updates and removals.

webhooks:document_delivery

Subscribe to delivery status changes.

webhooks:product_changes

Subscribe to product changes.

webhooks:document_payments

Subscribe to document payment events.

webhooks:document_comments

Subscribe to document comment events.

Parameters

Not sure what to enter? Here’s where to find IDs.

eventpath · stringrequired

The webhook event to get a sample payload for.One of formSubmitted, contactCreated, documentCreated, recipientFirstViewed, recipientSigned, contactUpdated, contactRemoved, documentDeliveryStatusChanged, productChanged, documentPaymentEvent, documentCommentEvent.

client_idquery · stringrequired

The Client ID of your OAuth client. It’s public, and goes on every request alongside your access token. Find it in QuoteCloud under Settings → API dashboard → Manage Integrations → OAuth Clients.Length at least 1.

statusquery · string

Document status for documentStatusChange; optional subtype for delivery (scheduled, paused_addon, queued, preparing, sending, sent, skipped, failed, needs_review, cancelled), product (created, updated, activated, deactivated), payment (received, failed, refunded), or comment (created, resolved, reopened).

Responses

200Zero or one sample events.

An array. Each item has:

Exactly one of these:

FormSubmissionSampleWebhook

idstringrequired

eventstringrequired

Always form_submission.

submissionIdstringrequired

documentIdstringrequired

recipientIdstring or nullrequired

submittedAtstring (date-time)required

valueCountintegerrequired

formSubmissionobjectrequired

Fields

idstringrequired

submissionIdstringrequired

documentIdstringrequired

recipientIdstring or nullrequired

submitterNamestring or nullrequired

submitterEmailstring or nullrequired

submittedAtstring (date-time)required

answerCountintegerrequired

answersTruncatedbooleanrequired

fieldDefinitionsTruncatedbooleanrequired

answersarray of objectrequired

Items at most 250.

Item fields

answerIdstringrequired

fieldIdstringrequired

fieldKeystringrequired

fieldLabelstringrequired

fieldTypestringrequired

fieldDefinitionFoundbooleanrequired

blockIdstringrequired

repeaterBlockIdstring or nullrequired

entryIdstringrequired

privateToAssigneebooleanrequired

valuestring or number or boolean or nullrequired

valueJsonstringrequired

valueTypestringrequired

One of text, number, date, options, boolean, files.

ContactEventSampleWebhook

idstringrequired

eventstringrequired

One of contact_created, contact_updated, contact_removed.

contactIdstringrequired

emailstringrequired

firstNamestringrequired

lastNamestring or nullrequired

fullNamestringrequired

phonestring or nullrequired

mobilestring or nullrequired

jobTitlestring or nullrequired

addressstring or nullrequired

createdAtstring (date-time)required

occurredAtstring (date-time)required

DocumentCreatedSampleWebhook

idstringrequired

eventstringrequired

Always document_created.

documentIdstringrequired

documentRefstringrequired

titlestringrequired

statusstringrequired

sourcestringrequired

ownerIdstringrequired

sourceDocumentIdstring or nullrequired

templateIdstring or nullrequired

createdAtstring (date-time)required

RecipientActivitySampleWebhook

idstringrequired

eventstringrequired

One of recipient_first_viewed, recipient_signed.

documentIdstringrequired

documentRefstringrequired

documentTitlestringrequired

documentStatusstringrequired

recipientIdstringrequired

recipientEmailstring or nullrequired

recipientNamestringrequired

occurredAtstring (date-time)required

ContactChangedWebhook

idstringrequired

eventstringrequired

One of contact_updated, contact_removed.

contactIdstringrequired

emailstringrequired

firstNamestringrequired

lastNamestring or nullrequired

fullNamestringrequired

phonestring or nullrequired

mobilestring or nullrequired

jobTitlestring or nullrequired

addressstring or nullrequired

changedFieldsarray of stringrequired

occurredAtstring (date-time)required

DocumentDeliveryWebhook

idstringrequired

eventstringrequired

Always document_delivery_status_changed.

deliveryRefstringrequired

documentIdstringrequired

documentRefstring or null

previousStatusstring or nullrequired

One of scheduled, paused_addon, queued, preparing, sending, sent, skipped, failed, needs_review, cancelled.

statusstringrequired

One of scheduled, paused_addon, queued, preparing, sending, sent, skipped, failed, needs_review, cancelled.

occurredAtstring (date-time)required

ProductChangedWebhook

idstringrequired

eventstringrequired

Always product_changed.

changestringrequired

One of created, updated, activated, deactivated.

productIdstringrequired

namestringrequired

skustringrequired

activebooleanrequired

changedFieldsarray of stringrequired

occurredAtstring (date-time)required

DocumentPaymentWebhook

idstringrequired

eventstringrequired

Always document_payment_event.

paymentEventstringrequired

One of received, failed, refunded.

transactionIdstringrequired

transactionRefstringrequired

documentIdstringrequired

documentRefstring or nullrequired

documentTitlestringrequired

documentStatusstringrequired

recipientIdstring or nullrequired

providerPaymentRefstringrequired

amountMinorintegerrequired

refundTotalMinorintegerrequired

currencystringrequired

statusstringrequired

payerEmailstring or nullrequired

failureCodestring or nullrequired

failureMessagestring or nullrequired

occurredAtstring (date-time)required

DocumentCommentWebhook

idstringrequired

eventstringrequired

Always document_comment_event.

commentEventstringrequired

One of created, resolved, reopened.

commentIdstringrequired

commentRefstringrequired

documentIdstringrequired

documentRefstring or nullrequired

documentTitlestringrequired

documentStatusstringrequired

bodystringrequired

statusstringrequired

One of open, resolved.

authorIdstringrequired

authorNamestring or nullrequired

authorEmailstring or nullrequired

createdAtstring (date-time)required

updatedAtstring (date-time)required

resolvedAtstring (date-time) or nullrequired

400Invalid request or validation failure.

dataobjectrequired

Fields

statusstringrequired

Always error.

messagestringrequired

codestring

documentRefstring

assetGenerationIdstring

errorsarray of object

Item fields

fieldstringrequired

messagestringrequired

401Missing or invalid bearer token or client ID.

errorstringrequired

error_descriptionstring

403Insufficient scope, missing add-on, usage limit, or permission denial.

Exactly one of these:

OAuthError

errorstringrequired

error_descriptionstring

ApiErrorEnvelope

dataobjectrequired

Fields

statusstringrequired

Always error.

messagestringrequired

codestring

documentRefstring

assetGenerationIdstring

errorsarray of object

Item fields

fieldstringrequired

messagestringrequired

429Shared company API request quota exceeded. Wait before retrying.

Retry-Afterheader · integer

Minimum seconds to wait before retrying.Value at least 1.

dataobjectrequired

Fields

statusstringrequired

Always error.

messagestringrequired

retryAfterSecondsintegerrequired

Value at least 1.

Rate limit

120 requests a minute per company, shared across REST, Zapier and MCP. On a 429, wait for Retry-After.