Skip to main content
Lusha Signals surface timely insights about contacts and companies - from job changes and promotions to hiring surges, headcount changes, and categorized news events. Instead of reaching out blindly, you can act on real triggers: a champion moved to a new company, or a target account doubled its engineering headcount. Signals help you keep CRM records current, prioritize outreach, and fire automations precisely when conditions are right.

​
What signals are

A signal is a detected change or event associated with a contact or company within a given time window. Each signal has a type (such as promotion or financialEventsNews) and a timestamp, so you know when the event occurred. Lusha provides two categories of signals:
  • Contact signals - changes tied to an individual, such as a job title promotion or a move to a new employer.
  • Company signals - events tied to an organization, such as a surge in hiring, a headcount change, or a news event.

​
One call per entity type

Signals is a consolidated, one-call-per-entity model: give an endpoint a list of IDs and the signal types you want, and it returns everything that matched - in a single request, no separate “search” step.

Contact Signals

POST /v3/contacts/signals - up to 100 contact IDs per request.

Company Signals

POST /v3/companies/signals - up to 100 company IDs per request.
Both endpoints take Lusha IDs. If you don’t have IDs yet, resolve contacts or companies first with Enrich Contacts / Enrich Companies or their Search & Enrich equivalents, then pass the returned id values into Signals.

​
Available signal types

​
Contact signals

​
Company signals

Hiring and workforce Headcount trends Technology and digital presence News events
Don’t hardcode this list. Call Get Contact Signal Types or Get Company Signal Types to fetch the current, authoritative list of signalTypes values at runtime.

​
Discover company signal filters

Company Signals results carry news-, department-, and location-specific detail. Two reference endpoints help you explore that taxonomy before you build a UI or automation on top of it:

Get Company Signal Filters

Discovery endpoint - lists the available filter types (newsEventTypes, hiringByDepartments, hiringByLocations) and whether each needs a search query.

Get Company Signal Filter Values

Returns the actual values for one filter type - a fixed list for newsEventTypes and hiringByDepartments, or a text-matched list for hiringByLocations.

​
Time window and credits

Pass a startDate in YYYY-MM-DD format to limit results to signals detected on or after that date. Use maxResultsPerSignal to cap how many instances of each signal type come back per contact or company.
Signals are charged per matched signal per result - showSignalsContact for Contact Signals and showSignalsCompany for Company Signals. Request only the signal types you need to manage consumption.

​
Next steps

Contact signals

Retrieve job changes and promotions for specific contacts.

Company signals

Retrieve hiring, headcount, and news events for specific companies.