> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sumble: Search Signals

> Search sales signals such as champion job changes, new hires, promotions, technology mentions and projects, with suggested contacts.

Search sales signals such as champion job changes, new hires, promotions, technology mentions and projects, with suggested contacts.

> [!NOTE]
>
> Tool ID: `sumble_search_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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'sumble_search_signals',
  {
    "filter": {
      "organization_ids": [
        123
      ],
      "person_ids": [
        123
      ],
      "signal_ids": [
        123
      ]
    }
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute sumble_search_signals --input '{
  "filter": {
    "organization_ids": [
      123
    ],
    "person_ids": [
      123
    ],
    "signal_ids": [
      123
    ]
  }
}' --json
```

## Example response

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

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "signals": [
      {
        "title": "VP of Engineering",
        "date": "2026-01-15T12:00:00Z",
        "display_type": "example"
      }
    ]
  }
}
```

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

## Input reference

Signals are sales-relevant events such as champion job changes, recent hires and promotions, technology and product mentions, projects and initiatives, and technology and job-function trends. Job-post signals (technology and product mentions, projects, and first mentions) also include `suggested_contacts`: the top few people to consider contacting at the account, plus a link to view all of them. Each signal also carries `account_status`: the CRM relationship between the signal's organization and the calling account ('is\_customer', 'is\_in\_crm', or 'is\_not\_in\_crm'). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot).

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filter` | `object` | No | — | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Signals are sales-relevant events such as champion job changes, recent hires and promotions, technology and product mentions, projects and initiatives, and technology and job-function trends. Job-post signals (technology and product mentions, projects, and first mentions) also include `suggested_contacts`: the top few people to consider reaching out to at the account, plus a link to view all of them. Each signal also carries `account_status`: the CRM relationship between the signal's organization and the calling account ('is_customer', 'is_in_crm', or 'is_not_in_crm'). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot).",
    "properties": {
      "filter": {
        "type": "object",
        "properties": {
          "organization_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Organization IDs to filter signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "person_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Sumble person IDs to filter signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "signal_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Signal IDs to filter signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "technology_slugs": {
            "type": [
              "array",
              "null"
            ],
            "description": "Canonical technology slugs to filter signals by, such as `kubernetes` or `salesforce`.",
            "items": {
              "type": "string"
            }
          },
          "job_functions": {
            "type": [
              "array",
              "null"
            ],
            "description": "Job function names to filter signals by, such as `Engineering` or `Sales`.",
            "items": {
              "type": "string"
            }
          },
          "priorities": {
            "type": [
              "array",
              "null"
            ],
            "description": "Priorities to filter signals by. Matches the `priority` field returned on each signal.",
            "items": {
              "type": "string",
              "enum": [
                "high",
                "medium",
                "low"
              ]
            }
          },
          "account_list_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Account list IDs to filter signals to accounts in those lists.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | Yes | — | Format: `uuid`. |
| `result.data.signals` | `array` | Yes | — | — |
| `result.data.signals[].signal_id` | `integer \| null` | No | — | — |
| `result.data.signals[].title` | `string` | Yes | — | — |
| `result.data.signals[].subtitle` | `string \| null` | No | — | — |
| `result.data.signals[].explanation` | `string \| null` | No | — | — |
| `result.data.signals[].sales_angle` | `string \| null` | No | — | — |
| `result.data.signals[].date` | `string` | Yes | — | Format: `date-time`. |
| `result.data.signals[].sumble_url` | `string \| null` | No | — | — |
| `result.data.signals[].display_type` | `string` | Yes | — | — |
| `result.data.signals[].type` | `string \| null` | No | — | — |
| `result.data.signals[].matched_technologies` | `array \| null` | No | — | — |
| `result.data.signals[].matched_technologies[].name` | `string` | Yes | — | — |
| `result.data.signals[].matched_technologies[].slug` | `string` | Yes | — | — |
| `result.data.signals[].matched_technologies[].label` | `string \| null` | No | — | — |
| `result.data.signals[].organization_name` | `string \| null` | No | — | — |
| `result.data.signals[].organization_id` | `integer \| null` | No | — | — |
| `result.data.signals[].job_post_id` | `integer \| null` | No | — | — |
| `result.data.signals[].person_id` | `integer \| null` | No | — | — |
| `result.data.signals[].linkedin_url` | `string \| null` | No | — | — |
| `result.data.signals[].location` | `string \| null` | No | — | — |
| `result.data.signals[].job_function` | `string \| null` | No | — | — |
| `result.data.signals[].priority` | `string \| null` | No | — | — |
| `result.data.signals[].suggested_contacts` | `object \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.people` | `array` | Yes | — | — |
| `result.data.signals[].suggested_contacts.people[].person_id` | `integer \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.people[].name` | `string \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.people[].title` | `string \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.people[].linkedin_url` | `string \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.people[].score` | `number \| null` | No | — | — |
| `result.data.signals[].suggested_contacts.sumble_url` | `string \| null` | No | — | — |
| `result.data.signals[].account_status` | `"is_customer" \| "is_in_crm" \| "is_not_in_crm"` | No | — | CRM relationship between the signal's organization and the calling account: 'is\_customer' (a customer account in the calling account's CRM), 'is\_in\_crm' (tracked in CRM but not a customer), or 'is\_not\_in\_crm' (no CRM record). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot). omitted otherwise, even when requested. Allowed: `is_customer`, `is_in_crm`, `is_not_in_crm`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "signals": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "signal_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "title": {
                  "type": "string"
                },
                "subtitle": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "explanation": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sales_angle": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "date": {
                  "type": "string",
                  "format": "date-time"
                },
                "sumble_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "display_type": {
                  "type": "string"
                },
                "type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "matched_technologies": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "label": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "name",
                      "slug"
                    ],
                    "additionalProperties": false
                  }
                },
                "organization_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "organization_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "job_post_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "person_id": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "linkedin_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "location": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "job_function": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "priority": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "suggested_contacts": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "people": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "person_id": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "linkedin_url": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "score": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "sumble_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "people"
                  ],
                  "additionalProperties": false
                },
                "account_status": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "CRM relationship between the signal's organization and the calling account: 'is_customer' (a customer account in the calling account's CRM), 'is_in_crm' (tracked in CRM but not a customer), or 'is_not_in_crm' (no CRM record). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot); omitted otherwise, even when requested.",
                  "enum": [
                    "is_customer",
                    "is_in_crm",
                    "is_not_in_crm"
                  ]
                }
              },
              "required": [
                "title",
                "date",
                "display_type"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "id",
          "signals"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [Sumble provider guide](https://deepline.com/docs/providers/sumble/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.