Add a party to template
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.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).
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-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
Create template party request
contactId*stringID of existing contact to add as a party
1 <= lengthrole*unknownParty role: SIGNER, ORGANIZER, or REVIEWER. (ACCEPTOR is deprecated and treated as SIGNER.)
"SIGNER"signingOrder?|Order for sequential signing
deliveryMethod?stringDefault delivery method
"EMAIL""SMS""NONE""IN_APP"requiredSignature?stringDefault 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"twoStepVerification?stringDefault 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"200
application/json- response
id*stringUnique template party identifier
templateId*stringTemplate ID this party belongs to
name*stringParty name
email?|Party email address
phone?|Party phone number
type*stringParty type: INDIVIDUAL or COMPANY
"INDIVIDUAL""COMPANY"role*stringParty role: SIGNER, ORGANIZER, or REVIEWER
"SIGNER""ORGANIZER""REVIEWER"signingOrder?|Order for sequential signing
contactId?|Linked contact ID
companyId?|Linked company ID
companyName?|Company name
companyRole?|Role within the company
companyOrgNumber?|Company organization number
externalId?|External reference ID
ssn?|Swedish personal number (personnummer)
country?|ISO 3166-1 alpha-3 country code (e.g. SWE)
requiredSignature?|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"deliveryMethod*stringDefault delivery method
"EMAIL""SMS""NONE""IN_APP"twoStepVerification*stringDefault 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"createdAt*unknownupdatedAt*unknowncurl -X POST 'https://app.sajn.se/api/v1/templates/string/parties' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{ "contactId": "string", "role": "SIGNER"}'{ "id": "string", "templateId": "string", "name": "string", "email": "string", "phone": "string", "type": "INDIVIDUAL", "role": "SIGNER", "signingOrder": 0, "contactId": "string", "companyId": "string", "companyName": "string", "companyRole": "string", "companyOrgNumber": "string", "externalId": "string", "ssn": "string", "country": "string", "requiredSignature": "NONE", "deliveryMethod": "EMAIL", "twoStepVerification": "NONE", "createdAt": null, "updatedAt": null}Was this page helpful?