Create a new contact

curl --request POST \
  --url https://app.sajn.se/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Kai",
  "lastName": "Lindqvist",
  "email": "[email protected]",
  "phone": "+46701740605",
  "externalId": "EMP-0142"
}
'

import requests

url = "https://app.sajn.se/api/v1/contacts"

payload = {
    "firstName": "Kai",
    "lastName": "Lindqvist",
    "email": "[email protected]",
    "phone": "+46701740605",
    "externalId": "EMP-0142"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'Kai',
    lastName: 'Lindqvist',
    email: '[email protected]',
    phone: '+46701740605',
    externalId: 'EMP-0142'
  })
};

fetch('https://app.sajn.se/api/v1/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => 'Kai',
    'lastName' => 'Lindqvist',
    'email' => '[email protected]',
    'phone' => '+46701740605',
    'externalId' => 'EMP-0142'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/contacts"

	payload := strings.NewReader("{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sajn.se/api/v1/contacts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cm4k2x9p10006abcd1234efgh",
  "email": "[email protected]",
  "phone": "+46701740605",
  "firstName": "Kai",
  "lastName": "Lindqvist",
  "nationalId": "191212121212",
  "externalId": "EMP-0142",
  "addressLine1": "Storgatan 12",
  "addressLine2": null,
  "postalCode": "411 38",
  "city": "Göteborg",
  "state": null,
  "country": "Sverige",
  "createdAt": "2026-09-15T10:30:00.000Z",
  "updatedAt": "2026-09-15T10:30:00.000Z",
  "companyRole": null,
  "company": null
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received undefined",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "firstName",
      "code": "INVALID_TYPE",
      "message": "Invalid input: expected string, received undefined"
    }
  ]
}

{
  "code": "UNAUTHORIZED",
  "message": "Invalid API token",
  "userMessage": "Ogiltig API-nyckel",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "Insufficient OAuth scope: requires contacts:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "contacts:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Contact not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "contact"
}

{
  "code": "INVALID_STATE",
  "message": "The resource's current state doesn't allow the operation, such as editing a document that was already sent or downloading a file that isn't produced yet.",
  "userMessage": "Åtgärden är inte möjlig i resursens nuvarande status.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "RATE_LIMITED",
  "message": "API rate limit exceeded",
  "userMessage": "För många förfrågningar. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error",
  "userMessage": "Något gick fel.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "UPSTREAM_UNAVAILABLE",
  "message": "A service the operation depends on, such as an eID provider or a connected integration, failed or is unavailable. Retry with exponential backoff.",
  "userMessage": "En extern tjänst svarar inte just nu. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

Contacts

Create a new contact

Create a new contact in your organization.

Required Fields:

firstName - Contact’s first name

Optional Fields:

lastName - Contact’s last name (omit or send an empty string for single-name contacts)
email - Email address
phone - Phone number (for SMS notifications)
nationalId - National identity number, such as a Swedish personnummer, for eID verification
externalId - Your external reference ID for tracking
companyId - Associate with existing company
companyRole - Role within the company
addressLine1, addressLine2, postalCode, city, state, country - The contact’s address

POST

api

contacts

Create a new contact

curl --request POST \
  --url https://app.sajn.se/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Kai",
  "lastName": "Lindqvist",
  "email": "[email protected]",
  "phone": "+46701740605",
  "externalId": "EMP-0142"
}
'

import requests

url = "https://app.sajn.se/api/v1/contacts"

payload = {
    "firstName": "Kai",
    "lastName": "Lindqvist",
    "email": "[email protected]",
    "phone": "+46701740605",
    "externalId": "EMP-0142"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: 'Kai',
    lastName: 'Lindqvist',
    email: '[email protected]',
    phone: '+46701740605',
    externalId: 'EMP-0142'
  })
};

fetch('https://app.sajn.se/api/v1/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => 'Kai',
    'lastName' => 'Lindqvist',
    'email' => '[email protected]',
    'phone' => '+46701740605',
    'externalId' => 'EMP-0142'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/contacts"

	payload := strings.NewReader("{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.sajn.se/api/v1/contacts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"Kai\",\n  \"lastName\": \"Lindqvist\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+46701740605\",\n  \"externalId\": \"EMP-0142\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cm4k2x9p10006abcd1234efgh",
  "email": "[email protected]",
  "phone": "+46701740605",
  "firstName": "Kai",
  "lastName": "Lindqvist",
  "nationalId": "191212121212",
  "externalId": "EMP-0142",
  "addressLine1": "Storgatan 12",
  "addressLine2": null,
  "postalCode": "411 38",
  "city": "Göteborg",
  "state": null,
  "country": "Sverige",
  "createdAt": "2026-09-15T10:30:00.000Z",
  "updatedAt": "2026-09-15T10:30:00.000Z",
  "companyRole": null,
  "company": null
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received undefined",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "firstName",
      "code": "INVALID_TYPE",
      "message": "Invalid input: expected string, received undefined"
    }
  ]
}

{
  "code": "UNAUTHORIZED",
  "message": "Invalid API token",
  "userMessage": "Ogiltig API-nyckel",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "Insufficient OAuth scope: requires contacts:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "contacts:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Contact not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "contact"
}

{
  "code": "INVALID_STATE",
  "message": "The resource's current state doesn't allow the operation, such as editing a document that was already sent or downloading a file that isn't produced yet.",
  "userMessage": "Åtgärden är inte möjlig i resursens nuvarande status.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "RATE_LIMITED",
  "message": "API rate limit exceeded",
  "userMessage": "För många förfrågningar. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error",
  "userMessage": "Något gick fel.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "UPSTREAM_UNAVAILABLE",
  "message": "A service the operation depends on, such as an eID provider or a connected integration, failed or is unavailable. Retry with exponential backoff.",
  "userMessage": "En extern tjänst svarar inte just nu. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

Authorizations

Authorization

string

header

required

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

Headers

Sajn-Version

enum<string>

API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.

Available options:

2026-09,

2026-10

Sajn-Workspace

string

ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.

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.

Maximum string length: 255

Body

application/json

Body

Create contact request

firstName

string

required

Contact first name (required)

Minimum string length: 1

lastName

string

Contact last name (optional, e.g. for single-name contacts)

string<email>

Contact email address

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

phone

string

Contact phone number

externalId

string

Your external reference ID for this contact

companyId

string

ID of company to associate with

companyRole

string

Role/title within the company

nationalId

string

National identity number, such as a Swedish personnummer

addressLine1

string | null

First line of the street address

addressLine2

string | null

Second line of the street address, such as a c/o line

postalCode

string | null

Postal code of the address

city

string | null

City of the address

state

string | null

State or region of the address

country

string | null

Country of the address, as free text, such as Sverige. It isn't validated as a country code.

Response

200

string

required

Unique contact identifier

string | null

required

Contact email address

phone

string | null

required

Contact phone number

firstName

string

required

Contact first name

lastName

string

required

Contact last name

nationalId

string | null

required

National identity number, such as a Swedish personnummer

externalId

string | null

required

Your external reference ID

addressLine1

string | null

required

First line of the street address

addressLine2

string | null

required

Second line of the street address, such as a c/o line

postalCode

string | null

required

Postal code of the address

city

string | null

required

City of the address

state

string | null

required

State or region of the address

country

string | null

required

Country of the address, as free text, as it was entered or imported. It isn't a country code, unlike a party's country.

createdAt

string<date-time>

required

Date and time when contact was created

updatedAt

string<date-time>

required

Date and time when contact was last updated

companyRole

string | null

required

Role/title within the associated company

company

object | null

required

The company the contact belongs to

Show child attributes

Get started

Core concepts

Guides

Webhooks

API fundamentals

Upgrading

sajn Login

API reference

Create a new contact

Authorizations

Headers

Body

Response