Add a party to template
Add a default party/signer to a template. You can either reference an existing contact via contactId, or provide name with optional email/phone/company details manually.
These parties are inherited as signers when a document is created from this template (unless overridden).
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
Bearer token for API authentication
Makes 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.
255Path Parameters
Body
Body
- Option 1
- Option 2
Create template party request
ID of existing contact to add as a party
1Party role: SIGNER, ORGANIZER, or REVIEWER. (ACCEPTOR is deprecated and treated as SIGNER.)
Order for sequential signing
Default delivery method
EMAIL, SMS, NONE, IN_APP Default signature type
NONE, DRAWING, SE_BANKID, MANUAL, CLICK_TO_SIGN, NO_BANKID_BIOMETRIC, NO_BANKID_HIGH, NO_QES, DK_MITID, DK_MITID_ERHVERV, FI_FTN, NL_IDIN Default two-step verification
NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, PIN_BEFORE_SIGNING, SE_BANKID_BEFORE_SIGNING, NO_BANKID_BIOMETRIC_BEFORE_SIGNING, NO_BANKID_HIGH_BEFORE_SIGNING, DK_MITID_BEFORE_SIGNING, DK_MITID_ERHVERV_BEFORE_SIGNING, FI_FTN_BEFORE_SIGNING, NL_IDIN_BEFORE_SIGNING Response
200
Unique template party identifier
Template ID this party belongs to
Party name
Party type: INDIVIDUAL or COMPANY
INDIVIDUAL, COMPANY Party role: SIGNER, ORGANIZER, or REVIEWER
SIGNER, ORGANIZER, REVIEWER Default delivery method
EMAIL, SMS, NONE, IN_APP Default two-step verification
NONE, PIN_BEFORE_SIGNING, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING, BANKID_BEFORE_SIGNING, NO_BANKID_BIOMETRIC_BEFORE_SIGNING, NO_BANKID_HIGH_BEFORE_SIGNING, DK_MITID_BEFORE_SIGNING, DK_MITID_ERHVERV_BEFORE_SIGNING, FI_FTN_BEFORE_SIGNING, NL_IDIN_BEFORE_SIGNING Party email address
Party phone number
Order for sequential signing
Linked contact ID
Linked company ID
Company name
Role within the company
Company organization number
External reference ID
Swedish personal number (personnummer)
ISO 3166-1 alpha-3 country code (e.g. SWE)
Default required signature type
NONE, DRAWING, BANKID, MANUAL, CLICK_TO_SIGN, NO_BANKID_BIOMETRIC, NO_BANKID_HIGH, NO_QES, DK_MITID, DK_MITID_ERHVERV, FI_FTN, NL_IDIN 
