Skip to Content
Identity and signing

Set the signing method for a party

Choose how each party signs and verifies their identity, from drawn signatures to BankID and eID

In this guide, you choose how each party signs a document and whether they verify their identity first. You list the methods your account can offer, set them per party, and add a verification step for the parties who need one.

Each party has two settings:

  • signatureMethod: how the party signs, such as with a drawn signature or with BankID.
  • signVerification: an optional check the party passes before signing, such as an SMS code.

The document also has documentMeta.openVerification, a check that every party passes before the document opens.

For what each method proves legally, see Signing methods.

Before you begin

  • Store your API key in the SAJN_API_KEY environment variable. To create a key, go to workspace settings in the sajn app, then Utvecklare (Developer) > API-nycklar (API keys).
  • Have a DRAFT document with parties. For more information, see Create a document.

Signing methods

The following values are available for signatureMethod:

ValueMethodThe party needs
DRAWINGDraws a signature with a mouse, trackpad, or finger.A browser.
CLICK_TO_SIGNClicks a button to sign.A browser.
SE_BANKIDSigns with Swedish BankID.Swedish BankID.
DK_MITIDSigns with Danish MitID, as a person.MitID.
DK_MITID_ERHVERVSigns with Danish MitID Erhverv, on behalf of a company.MitID Erhverv.
FI_FTNSigns with the Finnish Trust Network: Finnish bank credentials or Mobile ID.FTN credentials.
NL_IDINSigns with Dutch iDIN, through their bank.A Dutch bank that supports iDIN.

DRAWING and CLICK_TO_SIGN prove that the party intended to sign. The eID methods also prove who signed. With an eID, an optional nationalId on the party is matched against the eID; without one, sajn matches the name.

The API accepts the Norwegian BankID values in the schema, such as NO_BANKID_BIOMETRIC, but rejects them with the message This eID scheme is not yet available until the scheme is switched on. NONE and MANUAL are derived values: a party gets NONE when its role doesn't sign, and MANUAL marks a document imported after paper signing.

If you leave out signatureMethod, the party gets the workspace's default signing method. Without a workspace default, the party gets the national eID of your organization's country, or DRAWING when the country has none.

Set the methods on a document

List the methods you can offer

Build your picker from the API instead of a hard-coded list, because eID schemes are switched on market by market:

curl https://app.sajn.se/api/v1/helpers/signature-methods \
  -H "Authorization: Bearer $SAJN_API_KEY" \
  -H "Sajn-Version: 2026-10"

The response lists the eID methods first, then the generic ones:

{
  "data": [
    { "code": "SE_BANKID", "label": "BankID" },
    { "code": "DK_MITID", "label": "MitID" },
    { "code": "DK_MITID_ERHVERV", "label": "MitID Erhverv" },
    { "code": "FI_FTN", "label": "FTN (Finnish Trust Network)" },
    { "code": "NL_IDIN", "label": "iDIN" },
    { "code": "DRAWING", "label": "Drawn signature" },
    { "code": "CLICK_TO_SIGN", "label": "Click to sign" }
  ]
}

The list shows which methods sajn offers, not which your plan includes. For the plan rule, see Plan availability.

Set a method per party

Parties on the same document can use different methods. Set signatureMethod when you add the party, or update it on a draft:

curl -X POST https://app.sajn.se/api/v1/documents \
  -H "Authorization: Bearer $SAJN_API_KEY" \
  -H "Sajn-Version: 2026-10" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Supplier agreement",
    "templateId": "TEMPLATE_ID",
    "parties": [
      { "name": "Alex Andersson", "email": "alex@example.com", "role": "SIGNER",
        "signatureMethod": "SE_BANKID" },
      { "name": "Robin Laine", "email": "robin@example.net", "role": "SIGNER",
        "signatureMethod": "FI_FTN", "country": "FI" },
      { "name": "Kai Berg", "email": "kai@example.com", "role": "SIGNER",
        "signatureMethod": "CLICK_TO_SIGN" }
    ]
  }'

Replace TEMPLATE_ID with the ID of a template. country is the party's ISO 3166-1 alpha-2 country code. To change the method later, send a PATCH request to /api/v1/documents/DOCUMENT_ID/parties/PARTY_ID with signatureMethod.

Optional: Add a verification step

To make a party verify before signing, set signVerification. The following update asks Kai for a one-time SMS code. An SMS code needs a phone number on the party:

curl -X PATCH https://app.sajn.se/api/v1/documents/DOCUMENT_ID/parties/PARTY_ID \
  -H "Authorization: Bearer $SAJN_API_KEY" \
  -H "Sajn-Version: 2026-10" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+46700000000", "signVerification": "SMS" }'

To make every party verify before the document even opens, set documentMeta.openVerification on the document instead:

curl -X PATCH https://app.sajn.se/api/v1/documents/DOCUMENT_ID \
  -H "Authorization: Bearer $SAJN_API_KEY" \
  -H "Sajn-Version: 2026-10" \
  -H "Content-Type: application/json" \
  -d '{ "documentMeta": { "openVerification": "SE_BANKID" } }'

To give one party a different check before opening, set openVerification on the party. It overrides the document's for that party, and null uses the document's:

curl -X PATCH https://app.sajn.se/api/v1/documents/DOCUMENT_ID/parties/PARTY_ID \
  -H "Authorization: Bearer $SAJN_API_KEY" \
  -H "Sajn-Version: 2026-10" \
  -H "Content-Type: application/json" \
  -d '{ "openVerification": "SMS" }'

To remove a party's signVerification or the document's openVerification, set it to null. For the values, see the following section.

Verification steps

signVerification, documentMeta.openVerification, and a party's openVerification take the following values. To list the methods your account can use, with labels, call List selectable verification methods.

ValueThe partyNotes
nullIsn't asked to verify.The default.
SMSEnters a code sent by SMS.Needs a phone number.
EMAILEnters a code sent by email.Needs an email address.
PINEnters a PIN that you gave them.Works only as signVerification; a party's openVerification rejects it. You set the PIN in the sajn app.
SE_BANKIDIdentifies with Swedish BankID.
DK_MITIDIdentifies with MitID.
DK_MITID_ERHVERVIdentifies with MitID Erhverv.
FI_FTNIdentifies with FTN.
NL_IDINIdentifies with iDIN.

Use signVerification to protect the signature of one party, and openVerification to protect the content of the whole document. A party who signs with an eID is already identified, so an eID verification step on top of an eID signature is a second, separately billed eID transaction.

eID schemes by country

The same code names a scheme as a signing method and as a verification step:

CountryCode
SwedenSE_BANKID
DenmarkDK_MITID, and DK_MITID_ERHVERV for companies
FinlandFI_FTN
The NetherlandsNL_IDIN

Plan availability

Which eID schemes an organization can use depends on its plan:

  • On paid plans from Solo upward, every scheme in the preceding table is available.
  • On the free plan, only the national eID with included signatures is available, such as SE_BANKID for a Swedish organization.
  • In a sandbox organization, every scheme is available.

sajn checks the plan when you send the document. To see the included signatures and what you've used, call Get plan limits and usage.

Read how a party was verified

After signing, each party has identityVerified, which is true when an eID verified the party through the signature or a verification step. identityMismatch is true when the eID identity didn't match the intended party and the signature was still recorded. For the verified identities, call Get verified signer identities.

Handle errors

  • 400 VALIDATION_FAILED with the message This eID scheme is not yet available: the scheme isn't switched on. Pick a method from /helpers/signature-methods.
  • 403 PERMISSION_DENIED on send: a party's signing method or verification step isn't included in your plan. The userMessage names the method.

For the error shape and every code, see Errors.

Next steps

Signing methods

Learn what each method proves.

Verify identity with sajn ID

Verify a person without a document.

Send for signing

Send the document to its parties.

Was this page helpful?

Last updated on