Skip to main content
POST
Update Signal

Update Signal

Modify an existing signal monitor. Use the action field to specify what to change.

job_change / new_post / person_activity

Actions for profile-tracking signals. You can have several signals of one of these types; signal_id says which one to change.
string
required
"job_change", "new_post", or "person_activity"
string
The signal to change, from /signal/create or /signal/list. Can be left out only when you have exactly one signal of this type; with several, the request returns 400.
string
required
array
Required for add_profiles and remove_profiles. LinkedIn profile URLs to add or remove.
string
Required for update_webhook. The new delivery URL.
string
Optional with update_webhook. Updates the HMAC signing secret.
array
Required for update_emails. Replaces the current list. Your account email is always retained. Pass [] to remove all additional recipients.
string
Required for rename. The new display name. Names don’t need to be unique.
array
Required for update_activity_types. ["reactions"], ["comments"], or ["reactions", "comments"].
Credits: add_profiles costs 1 credit per profile added. Other actions are free.

Response


keyword_engagement / industry_engagement / company_engagement / person_engagement

Engagement signals support multiple monitors per account. All actions require signal_id (returned when the signal was created).
string
required
"keyword_engagement", "industry_engagement", "company_engagement", or "person_engagement"
string
required
The unique ID of the signal to update. Returned in the response when the signal was created.
string
required

update_targets

Replaces the primary targets for the signal. The required field depends on the signal type:
array
keyword_engagement only. New list of seed keywords. Replaces the current keywords entirely.
array
industry_engagement only. New list of industry names. Unrecognised names are skipped and reported in unresolved_industries.
array
company_engagement only. New list of LinkedIn company URLs. Unresolvable URLs are skipped and reported in unresolved_company_urls.
array
person_engagement only. New list of LinkedIn profile URLs to monitor. Unresolvable URLs are skipped and reported in unresolved_profile_urls.

update_icp

object
Replaces the full ICP filter. See ICP Filter Reference for all available fields. Pass {} to remove all filters.

update_webhook

string
required
The new delivery URL.
string
Updates the HMAC signing secret.

update_emails

array
required
Replaces the current recipient list. Your account email is always retained. Pass [] to remove all additional recipients.

update_tracking_mode (person_engagement only)

string
required
"posts" — posts authored by the tracked person · "mentions" — posts mentioning them · "both" — both.

rename

string
required
The new display name. Names don’t need to be unique.

Response


Notes

  • Returns 404 if the signal does not exist or does not belong to your account.
  • update_emails replaces the full recipient list — it does not append. Your account email is always retained.
  • To permanently delete a signal, use /signal/delete.
  • If the signal is running when you send a change, the response also has "pending": true and a note. The change is saved and takes effect when the current run finishes.