Skip to main content
PUT
/
contacts
/
upsert
Upsert contact
curl --request PUT \
  --url https://app.dilli.studio/api/v1/contacts/upsert \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "first_name": "<string>",
  "email": "jsmith@example.com"
}
'
{
  "id": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "jsmith@example.com",
  "notes": "<string>",
  "properties": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dilli.studio/llms.txt

Use this file to discover all available pages before exploring further.

Use the API Playground below to send this request with your X-Api-Key. The base URL and headers are prefilled; update any path, query, or body fields and click Send. Provide property values in the same format as update—an object keyed by active property definition keys for contacts. 
{
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "jane@example.com",
  "notes": "Met at Startup Week",
  "company_ids": ["01HCOMPANY01"],
  "properties": {
    "job_title": "CTO",
    "lifetime_value": 125000,
    "newsletter_opt_in": true
  }
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
first_name
string
required
​
email
string<email>
required
​
last_name
string | null
​
notes
string | null
​
company_ids
string[]
​
properties
object

Response

Updated

​
id
string

ULID

​
first_name
string
​
last_name
string | null
​
email
string<email>
​
notes
string | null
​
properties
object

Key/value map of property definition keys to their values

​
created_at
string<date-time>
​
updated_at
string<date-time>