Skip to main content
PATCH
/
api
/
objects
/
{objectType}
Update multiple fields
curl --request PATCH \
  --url https://app.useitem.io/api/objects/{objectType} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "id": 123,
  "email": "alex@acme.com",
  "name": "Alex M. Johnson",
  "fields": {
    "role": "Senior Engineer",
    "custom_score": 100,
    "industry": "Technology"
  },
  "profile_image_url": "<string>"
}
'
{
  "data": {
    "id": 123,
    "name": "Alex Johnson",
    "email": "alex@acme.com",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Your organization's API key (starts with sk_live_)

Path Parameters

​
objectType
string
required

The object type slug. Use contacts for People, companies for Companies, or the slug of a Custom Object (e.g., deals, tickets).

Singular forms (contact, company) are also accepted.

Body

application/json
​
id
integer

Record ID (required unless using email for contacts)

Example:

123

​
email
string

Contact email (alternative to id, contacts only)

Example:

"alex@acme.com"

​
name
string

Update the object name

Example:

"Alex M. Johnson"

​
fields
object

Key-value pairs of fields to update

Example:
{
  "role": "Senior Engineer",
  "custom_score": 100,
  "industry": "Technology"
}
​
profile_image_url
string<uri>

Response

Object updated

​
data
object

A flat object containing all fields. System fields (name, email, phone, etc.) and custom fields are merged into a single level — the custom_fields JSON column is flattened so every field is a top-level key.