Champion joined a new company or promoted
Parameters, defaults and rules of the "Champion joined a new company or promoted" signal template.
Detect when a champion changes company or gets promoted: the best window to reach out. Champions are the people of a champion list.
| Key | champion-joined-a-new-company-or-promoted |
| Category | my_network |
| 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 champion lists, from GET /v3/lists | — | The champion list to watch. |
| scopes | array of string | Yes | discovery, account_monitoring (at least one) | — | Where the signal looks. With only account monitoring, a move is kept only when the champion's current company is one of your key accounts (a promotion inside a key account counts too). |
| champion_moves | array of string | No | changed_company, changed_role_same_company (at least one) | ["changed_company", "changed_role_same_company"] | Which moves count: a change of company, a change of role inside the same company, or both. |
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: championin the response. No list is created for you. You can move the setup to another list later.- Setting this signal up does not need a persona.
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 champion list in this workspace. |
| 422 | parameters.scopes or parameters.champion_moves is empty. Send at least one value. |
| 409 | The signal template is archived. |
Example
parameters of a setup:
{
"list_id": 12,
"scopes": ["discovery"],
"champion_moves": ["changed_company"]
}