Records

Records are the rows in your object types. A company, a contact, a deal — each is a record with dynamic fields defined by its object type.

Tools

Tool	Description	Key Params
`records.list`	List records for an object type	`object_type_slug`, `filters`, `sort`, `page`, `page_size`
`records.get`	Get a single record by ID	`object_type_slug`, `record_id`
`records.create`	Create a new record	`object_type_slug`, `data`
`records.update`	Update a record’s fields	`object_type_slug`, `record_id`, `data`
`records.delete`	Soft-delete a record	`object_type_slug`, `record_id`
`records.search`	Full-text search across records	`query`, `object_type_slug` (optional)
`records.link`	Create a relation between two records	`from_record_id`, `to_record_id`
`records.unlink`	Remove a relation between two records	`from_record_id`, `to_record_id`
`records.bulk_create`	Create multiple records at once	`object_type_slug`, `records`

records.search searches across all object types by default. Pass object_type_slug to narrow results to a single type.

Examples

Create a company record

{
  "tool": "records.create",
  "params": {
    "object_type_slug": "companies",
    "data": {
      "Name": "Acme Corp",
      "Domain": "acme.com",
      "Industry": "Technology",
      "Employee Count": 250
    }
  }
}

Response:

{
  "success": true,
  "data": {
    "id": "rec_8f3a1b2c",
    "object_type_slug": "companies",
    "data": {
      "Name": "Acme Corp",
      "Domain": "acme.com",
      "Industry": "Technology",
      "Employee Count": 250
    },
    "created_at": "2026-03-23T10:15:00Z"
  }
}

Search for records

{
  "tool": "records.search",
  "params": {
    "query": "acme",
    "object_type_slug": "companies"
  }
}

Bulk create contacts and link to a company

{
  "tool": "records.bulk_create",
  "params": {
    "object_type_slug": "contacts",
    "records": [
      {
        "data": {
          "Name": "Jane Smith",
          "Email": "jane@acme.com",
          "Title": "CEO"
        }
      },
      {
        "data": {
          "Name": "Bob Johnson",
          "Email": "bob@acme.com",
          "Title": "CTO"
        }
      }
    ]
  }
}

{
  "tool": "records.link",
  "params": {
    "from_record_id": "rec_contact_01",
    "to_record_id": "rec_8f3a1b2c"
  }
}

Overview

Objects

Lists

Views

Notes

Tasks

Analytics

Reports

Timeline

Graph

Records

Tools

Examples

Create a company record

Search for records

Bulk create contacts and link to a company

​Tools

​Examples

​Create a company record

​Search for records

​Bulk create contacts and link to a company

Tools

Examples

Create a company record

Search for records

Bulk create contacts and link to a company