Engaged with competitors on LinkedIn
Parameters, defaults and rules of the "Engaged with competitors on LinkedIn" signal template.
Know when your prospects and competitors engage on LinkedIn: a sales cycle could be ongoing. It reads likes, comments and reposts on the pages and employees of the companies of a competitor list.
| Key | engaged-with-competitors-on-linkedin |
| Category | competition |
| Watches | person |
| Setups | Discovery and account monitoring |
Set this signal up with POST /v3/signal-setups: send the template's id as signal_template_id and the parameters below in parameters. Its id is in List signal templates. Any parameter not listed here is refused with a 422.
Parameters
| Parameter | Type | Required | Allowed values | Default | Description |
|---|---|---|---|---|---|
| list_id | integer | Yes | The ID of one of your competitor lists, from GET /v3/lists | — | The competitor list to watch. |
| scopes | array of string | Yes | discovery, account_monitoring (at least one) | — | Where the signal looks. |
| target_group | array of string | No | prospects, customers (at least one) | ["prospects"] | With Discovery, which of the competitor's employees are watched: prospects = its sales team (catches the people it is selling to), customers = its customer-facing team (catches its current customers), or both. No effect on account monitoring. |
Default is what the server stores when you leave the parameter out. — means there is no default: the parameter is required, or it is simply not set.
Rules
list_idcarriesx-list-type: competitorin the response. No list is created for you. You can move the setup to another list later.- Setting this signal up needs your persona to have at least one job title and one location, otherwise the request is refused with a
422. With several personas, sendpersona_idwhen you create the setup (see Create a signal setup).
Errors
A parameter that is missing, of the wrong type, or not an allowed value is refused with a 422 that names it under errors, for example parameters.scopes. These errors are specific to this signal template:
| Status | Cause |
|---|---|
| 422 | parameters.list_id is missing, or does not reference an existing competitor list in this workspace. |
| 422 | parameters.target_group is empty or holds another value. Send prospects, customers or both. |
| 409 | The signal template is archived. |
Example
parameters of a setup:
{
"list_id": 7,
"scopes": ["account_monitoring"],
"target_group": ["prospects", "customers"]
}