Skip to main content
PUT
Upsert multiple contacts

Authorizations

X-API-Key
string
header
required

Organization-scoped API key. Create one in the BuildingSwell app under Organization settings, API keys.

Query Parameters

update
string[]
required

Columns to overwrite when the row already exists. Repeat the parameter for each column: a single comma-separated value is read as one column name and fails at the database. Without the parameter the request is rejected with 400.

Body

application/json
name
string
required
id
string<uuid>

Optional client-supplied ID.

isArchived
boolean
identifier
string
email
string | null
phone
string | null
title
string | null
companyName
string | null
vendorId
string<uuid> | null
role
string | null
isPrimary
boolean
notes
string | null
metadata
object

Response

Successful response.

values
object[]