Sheets

A Sheet is a collection that stores entities discovered by your research workflows. Each sheet is linked to an ICP and contains entities of a single type.

What is a Sheet?

Sheets are where your research results live. They:

• Store discovered companies or contacts
• Define the schema for entity data
• Support custom fields for enrichment data
• Enable export to CSV and other formats

Sheet Structure

{
  "id": "507f1f77bcf86cd799439012",
  "name": "Q1 2025 Target Companies",
  "description": "Companies from Enterprise SaaS ICP",
  "icp_id": "507f1f77bcf86cd799439011",
  "entity_type": "company",
  "entity_schema": {
    "properties": {
      "name": {"type": "string"},
      "website": {"type": "string"},
      "industry": {"type": "string"}
    }
  }
}

Entity Types

Sheets support two entity types for different research use cases:

Default Schema Fields

Every sheet includes default fields based on its entity type. These are automatically populated by Linkt's research workflows.

Company Entities

Person Entities

Complex Field Types

Some default fields use complex types:

Location contains structured address data:

{
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "zip_code": "94105"
}

SocialMediaProfile contains platform and URL:

{
  "platform": "linkedin",
  "url": "https://linkedin.com/company/example"
}

See Entities for complete details on these types.

Sheet-ICP Relationship

Every sheet is linked to an ICP via the icp_id field. This relationship:

• Defines the targeting criteria for entities in the sheet
• Determines what custom enrichment fields are available
• Controls which tasks can write to the sheet

ICP (defines criteria) → Sheet (stores entities) → Entities (actual data)

Custom Fields

Add custom fields to capture ICP-specific enrichment data. Custom fields are defined by the ## Enrichment Fields section in your ICP description.

Supported Field Types

Schema Updates

You can add custom fields to a sheet's schema after creation. Fields defined in your ICP's enrichment section are automatically available.

See Custom Fields for advanced schema configuration.

Working with Sheet Data

Retrieving Entities

Entities in a sheet can be retrieved with pagination and filtering. Results include both default fields and custom enrichment data.

See Get Sheet Entities in the API Reference.

Exporting Data

Sheets support export to CSV format for use in external tools. Exports include all fields in the schema.

See Export Sheet to CSV in the API Reference.

Next Steps

• Entities - Understanding entity data structure
• Custom Fields - Advanced schema configuration
• Tasks - Execute workflows to populate sheets
• API Reference - Complete sheet endpoint documentation