Loading…
byCorgiLog inLog inStart free trialStart free trial
Subscribe to 26 platform events across 8 resources. Every delivery is signed with an HMAC-SHA256 header so you can verify the payload came from Dataroom and not a forged source.
Method
POSTSignature header
X-Dataroom-SignatureRetry policy
Exponential, 5 attempts
Compute an HMAC-SHA256 of the raw request body using the endpoint's signing secret (shown once on creation, rotatable from the endpoint kebab menu). Compare the result to the value in X-Dataroom-Signature.
// Node.js, verify an incoming webhook
import crypto from "node:crypto";
function verifyWebhook(
rawBody: string,
signature: string | null,
secret: string,
): boolean {
if (!signature) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(rawBody)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signature),
);
}Every event ships a JSON body with shape { id, type, createdAt, data }. The type matches the event key listed below.
Links
3Link created
link.createdLink viewed
link.viewedLink archived
link.archivedSignatures
7Envelope sent
envelope.sentEnvelope viewed
envelope.viewedEnvelope signed (by one signer)
envelope.signedEnvelope completed (all signed)
envelope.completedEnvelope declined
envelope.declinedEnvelope voided
envelope.voidedEnvelope reminded
envelope.remindedProposals
4Proposal sent
proposal.sentProposal viewed
proposal.viewedProposal accepted
proposal.acceptedProposal declined
proposal.declinedData rooms
3Data room created
dataroom.createdVisitor joined data room
dataroom.visitor.addedData room deleted
dataroom.deletedCRM
3Contact created
contact.createdContact updated
contact.updatedForm submitted
form.submittedRequests
3Request created
request.createdRequest fulfilled
request.fulfilledRequest reminded
request.remindedPipeline
1Deal stage changed
deal.stage_changedWorkflows
2Workflow run succeeded
workflow.run.successWorkflow run failed
workflow.run.failedBuild it: /settings/webhooks
Add a webhook endpoint, pick the events you care about, and start receiving deliveries. The dialog shows the same event catalog rendered on this page.