Skip to Content
Webhook eventsParties

document.party.added

Fires when a party is added to a document that's already sent.

Header Parameters

webhook-id*string

The event id. It stays the same across retries and replays, so deduplicate on it.

webhook-timestamp*string

When sajn sent this attempt, in Unix seconds. Reject a timestamp older than your tolerance, such as five minutes.

webhook-signature?string

One or more space-separated signatures, v1,<base64 HMAC-SHA256>, over <webhook-id>.<webhook-timestamp>.<raw request body>. The key is the base64 decoding of the secret after whsec_. Accept the request when any signature matches; for 24 hours after a secret rotation, there is one per secret. Any Standard Webhooks library verifies it. Webhooks created without a secret don't send this header.

Sajn-Version*"2026-10"

The endpoint's API version, the same value as apiVersion in the body.

Value in"2026-10"

Request Body

application/json
  1. body
id*string

Event ID, also in webhook-id. It's the same on every retry, replay and endpoint that receives the event, so deduplicate on it. To read the event again, pass it to GET /api/v1/events/{id}.

type*"document.party.added"
Value in"document.party.added"
createdAt*string

When the event happened. It doesn't change across retries and replays.

Formatdate-time
apiVersion*"2026-10"

The endpoint's API version, which sets the shape of data.

Value in"2026-10"
workspaceId*string
organizationId*string

The organization the event happened in.

environment*string

SANDBOX for an event in a sandbox organization.

Value in"PRODUCTION""SANDBOX"
actor*|null
data*

Response Body

Return any 2xx status code within 30 seconds to acknowledge the delivery. sajn retries any other status code, a redirect, a timeout and a network error with backoff for about three days, 12 attempts in all. A 410 Gone stops the retries and pauses the webhook.

Example Requests
POST/document.party.added
Request Body
application/json
{  "id": "cm4k2x9p10014abcd1234efgh",  "type": "document.party.added",  "createdAt": "2026-09-28T14:03:00.000Z",  "apiVersion": "2026-10",  "workspaceId": "cm4k2x9p10001abcd1234efgh",  "organizationId": "cm4k2x9p10000abcd1234efgh",  "environment": "PRODUCTION",  "actor": {    "type": "USER",    "id": "cm4k2x9p10002abcd1234efgh"  },  "data": {    "object": {      "id": "cm4k2x9p10003abcd1234efgh",      "externalId": "hr-offer-2026-114",      "expiresAt": "2026-10-28T22:00:00.000Z",      "name": "Anställningsavtal – Kai Lindqvist",      "status": "PENDING",      "documentMeta": {        "subject": "Ditt anställningsavtal från Exempelbolaget AB",        "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.",        "signingMode": "PARALLEL",        "forceReadFullDocument": true,        "showChatToSigners": false,        "language": "sv",        "value": null,        "redirectUrl": null,        "redirectEnabled": false,        "internalRecipients": [          "hr@example.com"        ],        "signableAfterExpired": false,        "sendPlainTextEmailOnly": null,        "reminderIntervalDays": 3,        "allowDelegation": false,        "openVerification": null,        "aiChatEnabled": null,        "nationalIdDisplayMode": null,        "sameDeviceSigning": false,        "documentCategoryId": "cm4k2x9p10017abcd1234efgh"      },      "createdAt": "2026-09-28T09:12:00.000Z",      "updatedAt": "2026-09-28T09:15:00.000Z",      "completedAt": null,      "deletedAt": null,      "templateId": "cm4k2x9p10008abcd1234efgh",      "folderId": "cm4k2x9p10011abcd1234efgh",      "responsibleUserId": "cm4k2x9p10002abcd1234efgh",      "parties": [        {          "documentId": "cm4k2x9p10003abcd1234efgh",          "phone": null,          "type": "INDIVIDUAL",          "company": null,          "contactId": null,          "nationalId": null,          "country": "SE",          "role": "SIGNER",          "signedAt": null,          "readStatus": "READ",          "signingStatus": "NOT_SIGNED",          "delivery": [            "EMAIL"          ],          "signatureMethod": "SE_BANKID",          "signVerification": null,          "openVerification": null,          "sendStatus": "DELIVERED",          "identityVerified": false,          "identityMismatch": false,          "createdAt": "2026-09-28T09:12:00.000Z",          "id": "cm4k2x9p10005abcd1234efgh",          "name": "Alex Berg",          "email": "alex@example.com",          "externalId": null,          "signingOrder": 1        },        {          "documentId": "cm4k2x9p10003abcd1234efgh",          "phone": "+46701740605",          "type": "INDIVIDUAL",          "company": null,          "contactId": "cm4k2x9p10006abcd1234efgh",          "nationalId": null,          "country": "SE",          "role": "SIGNER",          "signedAt": null,          "readStatus": "NOT_OPENED",          "signingStatus": "NOT_SIGNED",          "delivery": [            "EMAIL"          ],          "signatureMethod": "SE_BANKID",          "signVerification": null,          "openVerification": null,          "sendStatus": "DELIVERED",          "identityVerified": false,          "identityMismatch": false,          "createdAt": "2026-09-28T09:12:00.000Z",          "id": "cm4k2x9p10004abcd1234efgh",          "name": "Kai Lindqvist",          "email": "kai@example.com",          "externalId": "hr-candidate-4821",          "signingOrder": 2        }      ],      "tags": [],      "customFields": [],      "content": null,      "productTables": [],      "approvalRequestId": null,      "bundleId": null    },    "party": {      "documentId": "cm4k2x9p10003abcd1234efgh",      "phone": "+46701740605",      "type": "INDIVIDUAL",      "company": null,      "contactId": "cm4k2x9p10006abcd1234efgh",      "nationalId": null,      "country": "SE",      "role": "SIGNER",      "signedAt": null,      "readStatus": "NOT_OPENED",      "signingStatus": "NOT_SIGNED",      "delivery": [        "EMAIL"      ],      "signatureMethod": "SE_BANKID",      "signVerification": null,      "openVerification": null,      "sendStatus": "DELIVERED",      "identityVerified": false,      "identityMismatch": false,      "createdAt": "2026-09-28T09:12:00.000Z",      "id": "cm4k2x9p10004abcd1234efgh",      "name": "Kai Lindqvist",      "email": "kai@example.com",      "externalId": "hr-candidate-4821",      "signingOrder": 2    }  }}
Header Parameters
{  "webhook-id": "cm4k2x9p10014abcd1234efgh",  "webhook-timestamp": "1759304580",  "webhook-signature": "v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=",  "Sajn-Version": "2026-10"}

Was this page helpful?