Create Job Offers signal

Automatically detect new job postings that match your hiring criteria — filtered by job title, description keywords, location, and company profile — and receive each match on your webhook as it is found. Optionally enrich each hiring company with email, phone, French SIRENE, technology-stack, or homepage data, and target specific decision-maker roles at the company.

Input: signal name, webhookUrl, and a config object with job filters (jobTitleInclude, jobTitleExclude, jobTitleIncludeAll, jobDescriptionInclude, jobDescriptionExclude, jobDescriptionIncludeAll, or advanced boolean jobTitleQuery / jobDescriptionQuery, locations — optional, empty means worldwide — companySizeFilters, publishedDate), exclusions (excludedLocations, excludedCompanySizeFilters, companyIndustryExcluded, excludedWebsites), enrichment flags (getEmails, getPhones, getSireneData, detectTechnologies, getHomepageContent), and optional persona targeting (enablePersonaTargeting, targetPersonas, customPersonaTitles, excludedTitles, personaExportMode, maxLeadsPerCompany — 1-50 contacts per company, 1 when omitted — personaLocations, personaExcludedLocations, personaLocationsOnly — default false; true makes personaLocations alone decide where contacts are (empty = anywhere) while locations only targets the job; false keeps contacts within locations too — companyOnlyWhenContactsRefused — default false; on, a company whose candidates were all filtered out by your persona/location/size settings is still delivered, with no contact, instead of nothing — requireContact — default false; true = only leads with a contact are delivered: a company where nobody matching your personas is found is neither delivered nor charged, and this wins over companyOnlyWhenContactsRefused). Plus dailyLeadLimit (1–999,999, default 100) and initial status (draft | active | paused, default draft).

Output: 201 Created returns the signal (id, name, status, signalTypeId, webhookUrl, config, dailyLeadLimit, leadsToday, leadsTotal, duplicateHandling, createdAt, updatedAt, lastLeadAt). Each matching job is then delivered to your webhookUrl as a JSON payload with a signal block (job URL, title, description, location, publication date, source, matched keywords), a company block (name, website, LinkedIn URL, industry, location, employee count and range), and a contact field. contact is the empty string "" (never null) unless persona targeting is enabled; when enabled it is a contact object (first/last name, job title, email, phone, LinkedIn profile URL, Sales Navigator URL, location, and the matched persona name). Enrichment and persona fields are empty strings when unavailable. Note on locations: it is optional — omit it or send an empty list to search worldwide. Multiple locations are combined with OR, so each one you add widens the search. Pass names ("France"), not ids; an unrecognised name returns 400 INVALID_LOCATION. Worldwide signals can match a lot more, so size dailyLeadLimit accordingly.

Use cases:

• Hiring = budget — a company hiring for a function is investing in it; pitch the enabling tool for that team.
• Role-based targeting — a 'Head of X' opening → pitch X solutions to that department.
• Pre-arrival outreach — reach the hiring manager before the new hire starts.