Skip to main content
POST
/
api
/
objects
/
{objectType}
Update a single custom field
curl --request POST \
  --url https://app.useitem.io/api/objects/{objectType} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fieldName": "custom_score",
  "fieldValue": 95,
  "id": 123,
  "email": "alex@acme.com"
}
'
{
  "data": {
    "id": 123,
    "name": "Alex Johnson",
    "email": "alex@acme.com",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "message": "Updated custom field 'custom_score' for contact"
}

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
​
fieldName
string
required

Name of the custom field to update

Example:

"custom_score"

​
fieldValue
any
required

New value for the field

Example:

95

​
id
integer

Record ID (required for companies and custom objects)

Example:

123

​
email
string

Contact email (alternative to id for contacts)

Example:

"alex@acme.com"

Response

Field 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.

​
message
string
Example:

"Updated custom field 'custom_score' for contact"