Skip to main content
PUT
/
api
/
objects
/
{objectType}
Create an object
curl --request PUT \
  --url https://app.useitem.io/api/objects/{objectType} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Alex Johnson",
  "fields": {
    "email": "alex@acme.com",
    "role": "Engineer",
    "industry": "Technology",
    "custom_score": 95
  },
  "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
​
name
string
required

Display name for the object

Example:

"Alex Johnson"

​
fields
object

Key-value pairs of fields to set on the object

Example:
{
  "email": "alex@acme.com",
  "role": "Engineer",
  "industry": "Technology",
  "custom_score": 95
}
​
profile_image_url
string<uri>

Avatar URL (contacts) or logo URL (companies)

Response

Object created

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