MyAgentMail
Get started
All endpoints
LinkedIn — Signals

Fetch a signal

GEThttps://myagentmail.com/linkedin/signals/{id}

Path parameters

id
required
string

Responses

200application/json
signal
object
id
required
string
kind
required
"keyword" | "engagement" | "job_change_watchlist"

Acquisition strategy for this signal: - keyword: poll LinkedIn search for the saved query. - engagement: poll a tracked profile/company's recent posts and fire on engagers. - job_change_watchlist: poll a list of profiles weekly and fire on role/company changes.

enum: "keyword" | "engagement" | "job_change_watchlist"

name
required
string
query
string

Required for kind=keyword; null otherwise.

target
object

Engagement signals only — the resolved actor target.

kind
"profile" | "company"

enum: "profile" | "company"

url
string
urn
string

Resolved urn:li:fsd_profile:* or urn:li:fsd_company:*.

label
string
lastSeenPostUrn
string

Engagement signals only — watermark of the most recent post processed. We only fire on engagers of posts newer than this.

watchlistCount
integer

Watchlist signals only — number of profiles being tracked.

sessionId
string

null = auto-distribute polling across all healthy LinkedIn sessions for this tenant (recommended). Specific id = pin the signal to that account so all polls come from it.

cadence
required
"daily" | "every_12h" | "every_6h" | "manual"

enum: "daily" | "every_12h" | "every_6h" | "manual"

webhookUrl
string
webhookSecret
string

Returned only on creation. Verify with HMAC-SHA256.

filterMinIntent
required
"low" | "medium" | "high"

enum: "low" | "medium" | "high"

intentDescription
required
string

Plain-English firing rule the LLM classifier uses as the authoritative definition of what should fire. Example: "Flag as ready when the author is a founder/operator complaining about cold email — skip vendors, agencies, and content marketers." The keyword is only a coarse pre-filter; this rule decides engage=true/false and the cited reason on every match.

enabled
required
boolean
lastPolledAt
string

format: date-time

nextPollAt
string

format: date-time

lastError
string
lastErrorCode
string
lastErrorAt
string

format: date-time

matchesCount
integer
createdAt
string

format: date-time

updatedAt
string

format: date-time

404Not found.

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.