Skip to main content
POST
Create a new contact

Authorizations

Authorization
string
header
required

OAuth 2.0 access token for a connected application. Limited to the scopes granted at consent.

Headers

authorization
string
required

Bearer token for API authentication

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)

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

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 | null

Associated company information