Findymail: List Signals

Returns a paginated list of signals from monitors accessible by the authenticated user (owned and team-shared).

Tool ID: findymail_list_signals

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'findymail_list_signals',
  {
    "signal_type": "example",
    "monitor_id": 123,
    "date_from": "2026-01-15T12:00:00Z"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute findymail_list_signals --input '{
  "signal_type": "example",
  "monitor_id": 123,
  "date_from": "2026-01-15T12:00:00Z"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "id": 123,
        "type": "example",
        "category": "example"
      }
    ],
    "meta": {
      "current_page": 123,
      "per_page": 123,
      "total": 123
    }
  }
}

Use deepline describe findymail_list_signals --json for the latest machine-readable contract.

Input reference

Returns a paginated list of signals from monitors accessible by the authenticated user (owned and team-shared). Supports filtering by signal_type, monitor_id, and date range.

Name	Type	Required	Default	Details
`payload.signal_type`	`string`	No	—	Filter by signal type. Accepted values: `keyword_mention`, `new_hire`, `job_change`, `post_engagement`.
`payload.monitor_id`	`integer`	No	—	Filter by a specific monitor ID (must be accessible by the authenticated user).
`payload.date_from`	`string`	No	—	Filter signals detected on or after this date (format: YYYY-MM-DD).
`payload.date_to`	`string`	No	—	Filter signals detected on or before this date (format: YYYY-MM-DD).
`payload.relevance_scores`	`string`	No	—	Comma-separated AI relevance scores to include (0-5). Optionally combine with `monitor_id` to scope to a single monitor.
`payload.page`	`integer`	No	—	The page number (default: 1).
`payload.per_page`	`integer`	No	—	Results per page (max: 100, default: 50).

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`array`	No	—	—
`result.data.data[].id`	`integer`	No	—	—
`result.data.data[].type`	`string`	No	—	—
`result.data.data[].category`	`string`	No	—	—
`result.data.data[].payload`	`object`	No	—	—
`result.data.data[].payload.matched_keyword`	`string`	No	—	—
`result.data.data[].payload.snippet`	`string`	No	—	—
`result.data.data[].detected_at`	`string`	No	—	—
`result.data.data[].expires_at`	`string`	No	—	—
`result.data.data[].contact`	`object`	No	—	—
`result.data.data[].contact.id`	`integer`	No	—	—
`result.data.data[].contact.name`	`string`	No	—	—
`result.data.data[].contact.job_title`	`string`	No	—	—
`result.data.data[].contact.linkedin_url`	`string`	No	—	—
`result.data.data[].company`	`object`	No	—	—
`result.data.data[].company.id`	`integer`	No	—	—
`result.data.data[].company.name`	`string`	No	—	—
`result.data.data[].company.domain`	`string`	No	—	—
`result.data.data[].company.industry`	`string`	No	—	—
`result.data.data[].company.employee_count_range`	`string`	No	—	—
`result.data.data[].company.country`	`string`	No	—	—
`result.data.data[].monitors`	`array`	No	—	—
`result.data.data[].monitors[].id`	`integer`	No	—	—
`result.data.data[].monitors[].name`	`string`	No	—	—
`result.data.data[].monitors[].keywords`	`array`	No	—	—
`result.data.data[].monitors[].enrichment_level`	`string`	No	—	—
`result.data.data[].monitors[].relevance_score`	`integer`	No	—	—
`result.data.data[].monitors[].relevance_reasoning`	`string`	No	—	—
`result.data.meta`	`object`	No	—	—
`result.data.meta.current_page`	`integer`	No	—	—
`result.data.meta.per_page`	`integer`	No	—	—
`result.data.meta.total`	`integer`	No	—	—
`result.data.meta.last_page`	`integer`	No	—	—
`result.data.meta.from`	`integer`	No	—	—
`result.data.meta.to`	`integer`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation