Skip to main content
POST
Create Signal Agent
A Signal Agent is created as a draft by default. Pass segmentType, signalProcessingType and activate: true to run the full setup and start monitoring immediately. filters are validated against the chosen type — use List allowed filters to discover which filters a type accepts.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
name
string
required

Display name

type
enum<string>
required

Signal type to monitor

Available options:
companyIsHiring,
companyRaisedFunds,
recruitmentCampaign,
jobChange,
newHire,
companyEmployeeVisitedMyWebsite,
customSignals,
competitorConnections,
competitorReactions,
companyFollowers,
technologyChange,
linkedinPeopleProfile,
linkedinCompanyProfile,
mergersAcquisitions,
promotion,
linkedinKeywords,
externalSignalContact,
externalSignalCompany,
buyingIntent
filters
object[]

Filters to apply (validated against the signal type)

emoji
string

Emoji shown next to the agent name (defaults to a random emoji)

segmentType
enum<string>

Entity sourcing. Only all is supported via the API. Required together with signalProcessingType when activate is true.

Available options:
all
signalProcessingType
enum<string>

How detected signals are processed

Available options:
manual,
create_opportunity,
push_to_campaign
signalOpportunityTemplate
object

Task/opportunity template applied to each signal when signalProcessingType is create_opportunity.

activate
boolean

Fully set up and activate the agent. Requires segmentType and signalProcessingType.

Response

Created

data
object

A Signal Agent (watch list) configuration.