signals

Update Signal

Changed on

Change what a signal watches, or rename it.

Fields left out of the body keep their current value; send null to clear a cap or the enrollment template. Renaming also renames the destination list. Changing the detection filters restarts the signal's baseline, so the next check re-absorbs the new result set before importing. The preset and whether it imports people or companies cannot change — duplicate the signal and archive the original instead. Archived signals cannot be edited.

Requires the signals:write scope on the API key.

patch/v1/signals/{signal_id}

Request

  • Base URL: https://api.topo.io
  • URL: https://api.topo.io/v1/signals/{signal_id}
  • Auth: HTTP bearer

Path parameters

signal_idstring uuid required

ID of the signal.

Request body

namestring
search_filtersFilterTexts
max_per_runinteger nullable

Daily ceiling on imported entries. Send null to remove the cap.

max_companies_per_runinteger nullable

Daily ceiling on detected companies consumed. Send null to remove the cap.

max_contacts_per_companyinteger nullable

How many people to import per detected company. Send null to remove the cap.

enrich_emailboolean nullable

Whether imported leads get their email enriched.

enrich_phonesboolean nullable

Whether imported leads get their phone enriched.

sequence_template_idstring uuid nullable

Sequence template imported leads are enrolled into. People destinations only. Send null to stop enrolling.

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_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' | 'NEW_JOB' | 'CUSTOM_EVENT' | 'LINKEDIN_PARTNER_FOLLOWERS' | 'LINKEDIN_CUSTOMER_FOLLOWERS' | 'LINKEDIN_PARTNER_POST_ENGAGEMENT' | 'LINKEDIN_CUSTOMER_POST_ENGAGEMENT' | 'LINKEDIN_COMPANY_PAGE_POST_ENGAGEMENT' | 'LINKEDIN_OWN_PROFILE_POST_ENGAGEMENT' | 'LINKEDIN_OWN_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_COMPETITOR_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_PARTNER_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_CUSTOMER_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_OWN_BRAND_MENTION' | 'LINKEDIN_COMPETITOR_MENTION' | 'LINKEDIN_PARTNER_MENTION' | 'LINKEDIN_CUSTOMER_MENTION' | 'LINKEDIN_EVENT_MENTION' | 'COMPETITOR_TECH_ADOPTION' | 'INTEGRATION_TECH_ADOPTION' | 'LINKEDIN_EVENT_PAGE_FOLLOWERS' | 'CHAMPION_CHANGED_JOB' | 'CRM_LIST_ENTRY' 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.

urlstring required

Deep link to the signal in Topo.

list_urlstring nullable required

Deep link to the destination list in Topo.

search_filtersFilterTexts required
import_search_filtersFilterTexts required
sequence_template_idstring uuid nullable required

Sequence template the imported leads are enrolled into.

import_target'PEOPLE' | 'COMPANIES' required
event_subject'PEOPLE' | 'COMPANIES' required

Changes

  • 451748979321Revision changes
    • warning

      added the new linkedin_watched_engagement enum value to the / response property for the response status

    • warning

      added the new linkedin_watched_engagement enum value to the / response property for the response status

    • info

      added the new linkedin_watched_engagement enum value to the request property /////

    • info

      added the new linkedin_watched_engagement enum value to the request property /////

  • 5906bed561beRevision changes
    • warning

      added the new tech_min_confidence enum value to the / response property for the response status

    • warning

      added the new tech_min_confidence enum value to the / response property for the response status

    • info

      added the new tech_min_confidence enum value to the request property /////

    • info

      added the new tech_min_confidence enum value to the request property /////