Skip to main content
POST
/
api
/
v1
/
documents
/
{id}
/
signers
Add a signer to document
curl --request POST \
  --url https://app.sajn.se/api/v1/documents/{id}/signers \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "contactId": "<string>",
  "role": "SIGNER",
  "signingOrder": 123
}'
{
  "id": "<string>",
  "documentId": "<string>",
  "email": "jsmith@example.com",
  "name": "<string>",
  "phone": "<string>",
  "companyName": "<string>",
  "companyRole": "<string>",
  "companyOrgNumber": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "ssn": "<string>",
  "role": "SIGNER",
  "signingOrder": 123,
  "token": "<string>",
  "signedAt": "<any>",
  "readStatus": "NOT_OPENED",
  "signingStatus": "NOT_SIGNED",
  "signingUrl": "<string>"
}

Headers

​
authorization
string
required

Bearer token for API authentication

Path Parameters

​
id
string
required

Body

application/json

Body

Create signer request

​
contactId
string
required

ID of the contact to add as a signer

Minimum length: 1
​
role
enum<string>
default:SIGNER
required

Signer role (default: SIGNER)

Available options:
SIGNER,
ORGANIZER,
REVIEWER,
ACCEPTOR
​
signingOrder
number | null

Signing order for sequential signing (ignored for parallel)

Response

200

​
id
string
required

Unique signer identifier

​
documentId
string
required

Document ID this signer belongs to

​
name
string
required

Signer full name

​
role
enum<string>
required

Signer role: SIGNER, ORGANIZER, REVIEWER, or ACCEPTOR

Available options:
SIGNER,
ORGANIZER,
REVIEWER,
ACCEPTOR
​
token
string
required

Unique signing token

​
signedAt
any
required

Date and time when the signer signed (null if not signed)

​
readStatus
enum<string>
required

Read status: NOT_OPENED, OPENED, or READ

Available options:
NOT_OPENED,
OPENED,
READ
​
signingStatus
enum<string>
required

Signing status: NOT_SIGNED, SIGNED, or REJECTED

Available options:
NOT_SIGNED,
SIGNED,
REJECTED
​
signingUrl
string
required

Complete signing URL for this signer

​
email
string<email> | null

Signer email address

​
phone
string | null

Signer phone number (for SMS notifications)

​
companyName
string | null

Company name

​
companyRole
string | null

Role/title within the company

​
companyOrgNumber
string | null

Company organization number

​
externalId
string | null

Your external reference ID for this signer

​
companyId
string | null

Linked company ID

​
ssn
string | null

Swedish personal number (personnummer) - required for BankID signing

​
signingOrder
number | null

Order for sequential signing (null for parallel)

⌘I