Sign in
signals

Rename Signal

Rename a signal, and its destination list with it.

Detection filters, caps and enrichment settings are not editable here — recreate the signal to change what it watches.

Requires the signals:write scope on the API key.

patch/v1/signals/{signal_id}

Path parameters

signal_idstring uuid required

ID of the signal.

Request body

namestring required

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_PERSON_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 3 of the 13 revisions of this API.41

  • 0646a72cff021See the full diff
    • ●

      added the new LINKEDIN_PERSON_POST_ENGAGEMENT enum value to the response property for the response status

      response-property-enum-value-added

  • 5327ff62a22f3See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

  • 75e08cd17b3d1See the full diff
    • ○

      endpoint added

      endpoint-added