Create a new contact

Create a new contact in your organization.

Required Fields:

• firstName - Contact’s first name
• lastName - Contact’s last name

Optional Fields:

• email - Email address
• phone - Phone number (for SMS notifications)
• ssn - Swedish personal number (for BankID)
• externalId - Your external reference ID for tracking
• companyId - Associate with existing company
• companyRole - Role within the company

POST /api/v1/contacts

Create a new contact

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/contacts \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "[e-mail]",
  "phone": "<string>",
  "ssn": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "companyRole": "<string>"
}
'

200

{
  "id": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "phone": "<string>",
  "ssn": "<string>",
  "externalId": "<string>",
  "companyRole": "<string>",
  "company": {
    "id": "<string>",
    "name": "<string>",
    "orgNumber": "<string>"
  }
}

Headers

authorization · string · required

Bearer token for API authentication

Body

application/json

Body

Create contact request

firstName · string · required

Contact first name (required)

Minimum string length: 1

lastName · string · required

Contact last name (required)

Minimum string length: 1

email · 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

ssn · string

Swedish personal number (personnummer)

externalId · string

Your external reference ID for this contact

companyId · string

ID of company to associate with

companyRole · string

Role/title within the company

Response

200

application/json

200

id · string · required

Unique contact identifier

firstName · string · required

Contact first name

lastName · string · required

Contact last name

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

email · string | null

Contact email address

phone · string | null

Contact phone number

ssn · string | null

Swedish personal number (personnummer)

externalId · string | null

Your external reference ID

companyRole · string | null

Role/title within the associated company

company · object

Associated company information

Show child attributes