Skip to Content

Add a party to template

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/templates/{id}/parties

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).

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

Bearer token for API authentication

Idempotency-Key?string

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.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Create template party request

contactId*string

ID of existing contact to add as a party

Length1 <= length
role*unknown

Party role: SIGNER, ORGANIZER, or REVIEWER. (ACCEPTOR is deprecated and treated as SIGNER.)

Default"SIGNER"
signingOrder?|

Order for sequential signing

deliveryMethod?string

Default delivery method

Value in"EMAIL""SMS""NONE""IN_APP"
requiredSignature?string

Default signature type

Value in"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?string

Default two-step verification

Value in"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 Body

200

application/json
  1. response
id*string

Unique template party identifier

templateId*string

Template ID this party belongs to

name*string

Party name

email?|

Party email address

phone?|

Party phone number

type*string

Party type: INDIVIDUAL or COMPANY

Value in"INDIVIDUAL""COMPANY"
role*string

Party role: SIGNER, ORGANIZER, or REVIEWER

Value in"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

Value in"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*string

Default delivery method

Value in"EMAIL""SMS""NONE""IN_APP"
twoStepVerification*string

Default two-step verification

Value in"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*unknown
updatedAt*unknown
Example Request
curl -X POST 'https://app.sajn.se/api/v1/templates/string/parties' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "contactId": "string",  "role": "SIGNER"}'
Example Response
{  "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?