Objects

Create an object

Creates a new object of the specified type.

For contacts and companies, the system automatically deduplicates:

  • Contacts are matched by email — if a contact with the same email exists, it will be updated instead.
  • Companies are matched by domain, LinkedIn URL, or name similarity.

Custom objects are always created as new records.

put/api/objects/{objectType}

Request

  • Base URL
    https://app.useitem.io
  • Auth
    API key in header x-api-key

Request body

namestring required

Display name for the object

fieldsobject

Key-value pairs of fields to set on the object

profile_image_urlstring uri

Avatar URL (contacts) or logo URL (companies)

Example request

{
  "name": "Alex Johnson",
  "fields": {
    "email": "alex@acme.com",
    "role": "Engineer",
    "industry": "Technology",
    "custom_score": 95
  }
}

Response

Object created

Example response

{
  "data": {
    "id": 123,
    "name": "Alex Johnson",
    "email": "alex@acme.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.