Hiring for roles my product serves
Parameters, defaults and rules of the "Hiring for roles my product serves" signal template.
Spot companies hiring for the roles your product serves: they are building the team you sell to. The job titles are matched against the title of each job offer.
| Key | hiring-for-roles-my-product-serves |
| Category | people |
| Watches | company |
| Setups | account monitoring only |
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 |
|---|---|---|---|---|---|
| scopes | array of string | Yes | account_monitoring (at least one) | — | Where the signal looks. Only account monitoring is available. |
| use_persona_job_titles | boolean | No | true, false | true | Whether to also use the job titles of your persona, read at each run. |
| job_titles | array of string | No | Job titles | [] | The job titles to look for, on top of the persona's when use_persona_job_titles is true. |
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
- This signal supports account monitoring only. Discovery is refused.
- When you leave
use_persona_job_titlesout, it istrue. The persona's job titles are read at each run, never copied into the setup, so the signal follows any later change to the persona. - With one persona and no
persona_id, the setup is tied to your persona, so a persona you add later never changes the job titles it reads. - The titles you send in
job_titlesare added to the persona's. To look only for your own titles, senduse_persona_job_titles: false. - With several personas, send
persona_idwhenuse_persona_job_titlesistrueor left out: without it the request is refused with422, anderrorsnamespersona_id. - A persona is needed only when
use_persona_job_titlesistrue. Sendfalsewith your own job titles otherwise.
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.scopes contains discovery. Only account_monitoring is allowed. |
| 422 | parameters.job_titles is empty, use_persona_job_titles is true and your persona has no job title. Add job_titles, or add a job title to the persona first. |
| 422 | parameters.job_titles is empty while use_persona_job_titles is false. Send at least one job title. |
| 409 | The signal template is archived. |
Example
parameters of a setup:
{
"scopes": ["account_monitoring"],
"use_persona_job_titles": true,
"job_titles": ["Head of Sales"]
}