Engaged with my content on LinkedIn
Parameters, defaults and rules of the "Engaged with my content on LinkedIn" signal template.
Know when prospects engage with the client's posts, the client's company page or the content of the client's team. It reads the posts of the client's own company page and of the people on the client's "All my employees" list. With account monitoring, only engagers from the client's key accounts are kept.
| Key | engaged-with-my-content-on-linkedin |
| Category | my_network |
| Watches | person |
| Setups | Discovery and account monitoring |
Set this signal up with POST /v3/partner/workspaces/{partner_workspace_id}/signal-setups: send the template's id as signal_template_id and the parameters below in parameters. Its id is in List a client's signal templates. Any parameter not listed here is refused with a 422.
Parameters
| Parameter | Type | Required | Allowed values | Default | Description |
|---|---|---|---|---|---|
| scopes | array of string | Yes | discovery, account_monitoring (at least one) | — | Where the signal looks. |
| list_id | integer | No | The id of an employee list | The client's "All my employees" list | An employee list. Defaults to the client's All my employees list. |
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_iddefaults to the client's "All my employees" list:setup.fieldsshows its id as thedefault, it is stored when the setup is created and returned when you read it. Any employee list is accepted, and you can move the setup to another one later.nullis refused like for any parameter that has a default. Find its id with List the lists of a client (type=employee), and add or remove people with Add members and Remove a member.setup.fieldsdoes not show thelist_iddefault: the server applies it when the setup is created.- The company page read is always the client's own: there is no company page parameter, and
company_pageis refused like any unknown parameter. - Setting this signal up needs the client's 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 not an employee list of the workspace, or the workspace has no "All my employees" list yet (it is created from the workspace domain): "must be the id of an employee list of this workspace. See GET /v3/lists.". |
| 422 | parameters.list_id is null: "cannot be removed or set to null: send the new value instead, or leave it out to keep the current one". |
| 409 | The signal template is archived. |
Example
parameters of a setup:
{
"scopes": ["account_monitoring"]
}Read back with GET, the stored parameters carry the default list:
{
"scopes": ["account_monitoring"],
"list_id": 812
}