Add documents to a bundle
Adds draft documents to the bundle, up to 50 in total. A document's parties join the bundle's parties: a party whose email address the bundle already has is matched to it, and a new address becomes a new bundle party. A document without parties gets every bundle party. The bundle's settings are written onto the added documents. A document is refused with 409 when one email address has a different signing method, verification, role or personal number than in the bundle, or when its signing mode or party order differs from the bundle's.
Works only while the bundle is a DRAFT. On a sent bundle it returns 409 INVALID_STATE; withdraw it first with POST /api/v1/bundles/{id}/withdraw.
Permission required: EDIT_DOCUMENT on the workspace, and access to every document in the bundle. Requires a Team plan.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe bundle ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-Key?stringMakes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
length <= 255Body
application/json- body
documentIds*array<>Draft documents to add. Each one must be a DRAFT in the workspace that isn't in another bundle, and each of its parties needs an email address.
1 <= items <= 50200
application/json- response
id*stringThe document ID.
name*|The bundle name, shown as the heading of the bundle page and in the invitation.
status*stringDRAFT while you build it, and again after a withdraw. OPEN from the send until every document is resolved, then COMPLETED. CANCELED after a cancel.
"DRAFT""OPEN""COMPLETED""CANCELED"subject*|The subject line of the invitation email.
message*|A message included in every invitation.
expiresAt*|The expiry date of the bundle. Every document in it gets the same one.
date-timesigningMode*stringHow the parties sign: PARALLEL, all at once, or SEQUENTIAL, one at a time in the order of each party's signingOrder. The order runs across every document in the bundle.
"PARALLEL""SEQUENTIAL"language*stringLanguage of the bundle page and the emails to the parties, an ISO 639-1 code such as sv.
"sv""en""no""da""fi""de""is""es""fr""it"reminderIntervalDays*|Days between automatic reminders. 0 turns them off, and null uses the default of 3.
-9007199254740991 <= value <= 9007199254740991signableAfterExpired*booleanWhether the documents can still be signed after expiresAt.
internalRecipients*array<string>Email addresses that receive a copy of each sealed PDF once its document is completed.
nationalIdDisplayMode*|How national identity numbers are displayed to signers: FULL, PARTIAL, or NONE. null keeps each document's own setting.
"FULL""PARTIAL""NONE"nullopenVerification*|Verification every party passes before the document opens: PIN, SMS, EMAIL, or an eID such as SE_BANKID. null means none. A party's own openVerification overrides it.
"PIN""SMS""EMAIL""SE_BANKID""NO_BANKID_BIOMETRIC""NO_BANKID_HIGH""DK_MITID""DK_MITID_ERHVERV""FI_FTN""NL_IDIN"nullsendPlainTextEmailOnly*|Send plain text invitations only, without HTML. null inherits the workspace default.
redirectUrl*|URL to send a party to once they have signed.
redirectEnabled*booleanWhether redirectUrl is used.
documentCount*integerThe number of documents in documents.
-9007199254740991 <= value <= 9007199254740991createdAt*stringWhen the document was created.
date-timeupdatedAt*stringWhen the document was last updated.
date-timedocuments*array<>The documents in the bundle, oldest first.
parties*array<>The bundle's parties, in signing order.
curl -X POST 'https://app.sajn.se/api/v1/bundles/cm4k2x9p10044abcd1234efgh/documents' \ -H 'Content-Type: application/json' \ -d '{ "documentIds": [ "cm4k2x9p10022abcd1234efgh" ]}'{ "id": "cm4k2x9p10003abcd1234efgh", "name": "Anställningspaket – Kai Lindqvist", "status": "DRAFT", "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.", "expiresAt": "2026-10-28T22:00:00.000Z", "signingMode": "PARALLEL", "language": "sv", "reminderIntervalDays": 3, "signableAfterExpired": false, "internalRecipients": [ "hr@example.com" ], "nationalIdDisplayMode": "FULL", "openVerification": "PIN", "sendPlainTextEmailOnly": false, "redirectUrl": null, "redirectEnabled": true, "documentCount": 1, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z", "documents": [ { "id": "cm4k2x9p10003abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "status": "DRAFT", "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "bundlePartyId": "cm4k2x9p10004abcd1234efgh", "name": "Kai Lindqvist", "email": "kai@example.com", "role": "SIGNER", "signingStatus": "NOT_SIGNED", "signedAt": null } ] } ], "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "name": "Kai Lindqvist", "email": "kai@example.com", "phone": "+46701740605", "role": "SIGNER", "signingOrder": 1, "delivery": [ "EMAIL" ], "signatureMethod": "SE_BANKID", "signVerification": "PIN", "openVerification": "PIN", "status": "PENDING", "documentIds": [ "cm4k2x9p10003abcd1234efgh" ] } ]}Was this page helpful?