Sign in
signals

Create Signal

Create a signal from a catalog preset.

The signal checks its provider daily and imports the qualified leads or companies into a destination list it creates under the same name. Read GET /v1/signals/presets first to pick the preset and learn which detection filters it takes. The signal starts active and runs a first check immediately.

Requires the signals:write scope on the API key.

post/v1/signals

Request body

signal_type'LINKEDIN_OWN_POST_ENGAGEMENT' | 'LINKEDIN_COMPETITOR_POST_ENGAGEMENT' | 'LINKEDIN_KEYWORD_MENTION' | 'LINKEDIN_OWN_COMPANY_FOLLOWERS' | 'LINKEDIN_COMPETITOR_FOLLOWERS' | 'LINKEDIN_COMPANY_PAGE_FOLLOWERS' | 'HIRING_SIGNALS' | 'JOB_DESCRIPTION_KEYWORD' | 'FUNDING_EVENTS' | 'TECH_ADOPTION' | 'NEWS_EVENTS' | 'CUSTOM_EVENT' required
namestring required
search_filtersFilterTexts
import_target'PEOPLE' | 'COMPANIES'
event_subject'PEOPLE' | 'COMPANIES'
max_per_runinteger nullable

Daily ceiling on imported entries. Cannot be combined with max_companies_per_run.

max_companies_per_runinteger nullable

Daily ceiling on detected companies consumed. Only for a company preset importing people.

max_contacts_per_companyinteger nullable

How many people to import per detected company. Requires max_companies_per_run.

enrich_emailboolean

Whether imported leads get their email enriched.

enrich_phonesboolean

Whether imported leads get their phone enriched.

sequence_template_idstring uuid nullable

Sequence template imported leads are enrolled into. People destinations only.

import_search_filtersFilterTexts

Response

Successful Response

idstring uuid required

Unique identifier of the signal.

namestring nullable required

Name of the signal and of its destination list.

signal_type'LINKEDIN_OWN_POST_ENGAGEMENT' | 'LINKEDIN_COMPETITOR_POST_ENGAGEMENT' | 'LINKEDIN_KEYWORD_MENTION' | 'LINKEDIN_OWN_COMPANY_FOLLOWERS' | 'LINKEDIN_COMPETITOR_FOLLOWERS' | 'LINKEDIN_COMPANY_PAGE_FOLLOWERS' | 'HIRING_SIGNALS' | 'JOB_DESCRIPTION_KEYWORD' | 'FUNDING_EVENTS' | 'TECH_ADOPTION' | 'NEWS_EVENTS' | 'CUSTOM_EVENT' required
status'ACTIVE' | 'PAUSED' | 'ARCHIVED' required
cadence'DAILY' | 'WEEKLY' required
max_per_runinteger nullable required

Daily ceiling on imported entries, when one was set.

max_companies_per_runinteger nullable required

Daily ceiling on detected companies consumed, when one was set.

max_contacts_per_companyinteger nullable required

People imported per detected company, when one was set.

max_per_dayinteger required

Ceiling on the entries the signal imports in one day, resolved from the caps above.

enrich_emailboolean required

Whether imported leads get their email enriched.

enrich_phonesboolean required

Whether imported leads get their phone enriched.

imported_countinteger required

Entries the signal has imported since it was created.

contact_list_idstring uuid nullable required

Destination list, when the signal imports people.

account_list_idstring uuid nullable required

Destination list, when the signal imports companies.

created_atstring date-time required

When the signal was created.

archived_atstring date-time nullable required

When the signal was retired, if it was.

Changes

Changed in 2 of the 12 revisions of this API.36

  • 5327ff62a22f35See the full diff
    • ●

      added the new LINKEDIN_COMPANY_PAGE_FOLLOWERS enum value to the signal_type response property for the response status 201

      response-property-enum-value-added

    • ●

      added the new LINKEDIN_COMPETITOR_FOLLOWERS enum value to the signal_type response property for the response status 201

      response-property-enum-value-added

    • ●

      added the new LINKEDIN_OWN_COMPANY_FOLLOWERS enum value to the signal_type response property for the response status 201

      response-property-enum-value-added

    • ○

      added the new LINKEDIN_COMPANY_PAGE_FOLLOWERS enum value to the request property signal_type

      request-property-enum-value-added

    • ○

      added the new LINKEDIN_COMPETITOR_FOLLOWERS enum value to the request property signal_type

      request-property-enum-value-added

    • ○

      added the new LINKEDIN_OWN_COMPANY_FOLLOWERS enum value to the request property signal_type

      request-property-enum-value-added

    • ○

      added the new linkedin_followed_company_url_or enum value to the request property import_search_filters/propertyNames/

      request-property-enum-value-added

    • ○

      added the new linkedin_followed_company_url_or enum value to the request property search_filters/propertyNames/

      request-property-enum-value-added

  • 75e08cd17b3d1See the full diff
    • ○

      endpoint added

      endpoint-added