Skip to main content
A contact is a person you send documents to more than once. A company groups contacts who work for the same organization. Both belong to a workspace. When you add a contact to a document, sajn creates a party from it. The party takes a copy of the contact’s details, so a later change to the contact doesn’t change documents you already created.

​
Contact fields

The following request body creates a contact:
To create it, send the body to POST /contacts. The response is the contact, with the full company in company.

​
Companies

A company has a name, an optional orgNumber, and an optional country. To link a contact to a company, set the contact’s companyId. To read a company, call GET /companies/{id}, and to list its contacts, call GET /contacts?companyId=. To find companies, filter GET /companies by orgNumber or name. To find a company’s details in the business registry by its organization number, call GET /company-registry/{orgNumber}.

​
Use a contact on a document

To add a contact as a party, send its contactId, either in parties when you create the document, or to POST /documents/{id}/parties:
The party gets the contact’s name, email, phone number, national ID, and company. The party’s contactId links back to the contact.

​
Find contacts

To list contacts, call GET /contacts. Use query to search first name, last name, email, phone, and company. To filter, pass email, phone, externalId, companyId, or tagId; a contact must match every filter you pass. For pagination, see Pagination. Before you create a contact, look it up by email or externalId, so you don’t create duplicates. If you sync contacts from another system, store that system’s ID in externalId.

​
Delete a contact

DELETE /contacts/{id} deletes a contact permanently and returns its id with deleted set to true. Parties created from the contact keep their own copy of its details and are unlinked from it, so existing documents don’t change.

​
Next steps

Parties

Roles, signing order, delivery, and verification.

Managing contacts

Create, search, and update contacts.

Working with companies

Group contacts by company.