1eye Docs – Buyer Signals API, Webhooks, MCP & Integrations

Personas describe the roles and kinds of people your team sells to. Use resource: "personas" with each knowledge base tool on this page. short_name is the brief label shown in the 1eye app.

Creation fields	Values
Required	`name`, `short_name`
Optional	`description`

Fields accept strings or null as applicable. Required fields must be supplied when creating an item and cannot be cleared when updating it. Read the current record and confirm the exact proposal before creating, updating, or deleting. The examples below are MCP tool arguments. Replace uppercase IDs with values returned by your workspace.

Tools

list_kb — Read-only.
get_kb — Read-only.
create_kb — Change; confirmation required.
update_kb — Change; confirmation required.
delete_kb — Change; confirmation required.

`list_kb`

Read-only List buyer personas.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"personas"` for this page.
`limit`	number	No	Page size; defaults to 100.
`cursor`	string	No	Opaque continuation cursor from the same list.
`sort_order`	`asc` or `desc`	No	Oldest or newest first; defaults to `desc`.

Example

{
  "resource": "personas",
  "limit": 10
}

Returns: A paginated list with total, data, and next_cursor.

`get_kb`

Read-only Retrieve a persona.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"personas"` for this page.
`id`	string	Yes	An item ID returned by `list_kb`.

Example

{
  "resource": "personas",
  "id": "PERSONA_ID"
}

Returns: The item and the fields applicable to its resource type.

`create_kb`

Change · confirmation required Create a persona. Confirm the complete proposed item before creating it. Knowledge base changes affect how 1eye finds and qualifies buyers.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"personas"` for this page.
`fields`	object	Yes	Resource fields. See the creation requirements above; updates supply only fields to change.

Example

{
  "resource": "personas",
  "fields": {
    "name": "Marketing leaders",
    "short_name": "Marketing",
    "description": "Heads of Marketing and CMOs at target companies."
  }
}

Returns: The created knowledge base item.

`update_kb`

Change · confirmation required Update a persona. Confirm the item and field changes first. Omitted fields remain unchanged. Send null or an empty string to clear an optional field; required fields cannot be cleared.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"personas"` for this page.
`id`	string	Yes	Item ID.
`fields`	object	Yes	Resource fields. See the creation requirements above; updates supply only fields to change.

Example

{
  "resource": "personas",
  "id": "PERSONA_ID",
  "fields": {
    "short_name": "Marketing Updated"
  }
}

Returns: The updated item.

`delete_kb`

Change · confirmation required Delete a persona. Confirm the named item before deleting it. Deletion cannot be undone through this tool.

Arguments

Argument	Type	Required	Description
`resource`	string	Yes	Use `"personas"` for this page.
`id`	string	Yes	Item ID.

Example

{
  "resource": "personas",
  "id": "PERSONA_ID"
}

Returns: The deletion result.

Get Started

Using MCP

Buyers

Signals

Target Lists

Destinations

Knowledge Base

Workspace

Personas

Tools

`list_kb`

Arguments

Example

`get_kb`

Arguments

Example

`create_kb`

Arguments

Example

`update_kb`

Arguments

Example

`delete_kb`

Arguments

Example

​Tools

​list_kb

​Arguments

​Example

​get_kb

​Arguments

​Example

​create_kb

​Arguments

​Example

​update_kb

​Arguments

​Example

​delete_kb

​Arguments

​Example

Tools

`list_kb`

Arguments

Example

`get_kb`

Arguments

Example

`create_kb`

Arguments

Example

`update_kb`

Arguments

Example

`delete_kb`

Arguments

Example