Skip to main content
POST
Valider le webhook du moniteur

Autorisations

pubrio-api-key
string
header
requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json
destination_config
object
requis

Configuration de la destination. Pour un webhook : nécessite webhook_url (chaîne), et facultativement headers (objet) et body (objet). Pour un e-mail : accepte email (chaîne) ou emails (tableau de chaînes). Pour les séquences : nécessite sequence_identifier (chaîne) ainsi qu'au moins l'un des paramètres is_people_search_enrolled / is_company_contact_enrolled défini sur true.

Exemple:
monitor_id
string<uuid>

Identifiant unique d'un moniteur existant à tester. Facultatif pour tester de nouvelles configurations.

name
string

Nom du moniteur.

description
string

Description du moniteur.

detection_mode
enum<string>

Mode de détection des signaux. signal_first scanne largement le marché ; company_first suit une liste de comptes nommés et nécessite au moins une entreprise, un domaine ou une URL LinkedIn. Immuable après création — sa modification sur un moniteur existant renvoie 40021. Créez plutôt un nouveau moniteur.

Options disponibles:
company_first,
signal_first
signal_types
enum<string>[]

Types de signaux à surveiller.

Options disponibles:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

Une entrée par flux de signal surveillé par le moniteur.

Exemple:
company_filters
object

Filtres d'entreprise globaux. Accepte les mêmes paramètres que le point de terminaison Recherche d'entreprises.

Exemple:
companies
string<uuid>[]

Liste d'UUID domain_search_id d'entreprise. Alternative : utilisez domains ou linkedin_urls.

domains
string[]

Liste de domaines d'entreprise. Alternative à companies.

linkedin_urls
string<uri>[]

Liste d'URL LinkedIn d'entreprise. Alternative à companies.

is_company_enrichment
boolean

Indique s'il faut enrichir les données d'entreprise.

is_people_enrichment
boolean

Indique s'il faut enrichir les données de personnes.

people_enrichment_configs
object[]

Tableau de couches d'enrichissement de personnes. Contient max_people_to_return (1-25), people_contact_types (voir Rachat) et filters (voir Recherche de personnes).

Exemple:
destination_type
enum<string>

Type de destination de livraison.

Options disponibles:
webhook,
email,
sequences
frequency_minute
integer

Fréquence de déclenchement en minutes. Min : 0, Max : 10080.

Plage requise: 0 <= x <= 10080
max_failure_trigger
integer

Nombre maximal d'échecs consécutifs avant la mise en pause. Min : 1, Max : 10.

Plage requise: 1 <= x <= 10
max_daily_trigger
integer

Nombre maximal de déclenchements par jour. Min : 0, Max : 86400.

Plage requise: 0 <= x <= 86400
max_records_per_trigger
integer

Contrôle le nombre maximal d'enregistrements livrés par déclenchement. Des valeurs plus faibles réduisent la taille de la charge utile par livraison, ce qui est recommandé pour les jeux de résultats volumineux ou les intégrations à débit limité. Min : 1, Max : 100, Par défaut : 25. Consultez Configuration des webhooks pour plus d'indications.

Plage requise: 1 <= x <= 100
notification_email
string<email>

E-mail pour les notifications d'échec.

max_retry_per_trigger
integer

Nombre maximal de nouvelles tentatives par déclenchement. Min : 0, Max : 3.

Plage requise: 0 <= x <= 3
retry_delay_second
integer

Délai entre les tentatives, en secondes. Min : 1, Max : 5.

Plage requise: 1 <= x <= 5

Réponse

Réponse réussie contenant les résultats de la validation du webhook — la configuration de destination ainsi que les charges utiles de requête/réponse du test. En cas d'échec du webhook, le point de terminaison répond 400 (MONITOR_WEBHOOK_URL_INVALID) avec la réponse du webhook dans les détails de l'erreur.

data
object