Skip to main content
POST
Monitor-Webhook validieren

Autorisierungen

pubrio-api-key
string
header
erforderlich

Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich Settings erstellen.

Body

application/json
destination_config
object
erforderlich

Konfiguration des Ziels. Für Webhook: erfordert webhook_url (String), optional headers (Objekt) und body (Objekt). Für E-Mail: akzeptiert email (String) oder emails (Array von Strings). Für Sequenzen: erfordert sequence_identifier (String) plus mindestens eines von is_people_search_enrolled / is_company_contact_enrolled auf true gesetzt.

Beispiel:
monitor_id
string<uuid>

Eindeutige Kennung eines bestehenden Monitors zum Testen. Optional beim Testen neuer Konfigurationen.

name
string

Name des Monitors.

description
string

Beschreibung des Monitors.

detection_mode
enum<string>

Wie Signale erkannt werden. signal_first durchsucht den Markt breit; company_first verfolgt eine benannte Kontenliste und erfordert mindestens ein Unternehmen, eine Domain oder eine LinkedIn-URL. Nach der Erstellung unveränderlich — das Ändern bei einem bestehenden Monitor gibt 40021 zurück. Erstellen Sie stattdessen einen neuen Monitor.

Verfügbare Optionen:
company_first,
signal_first
signal_types
enum<string>[]

Zu überwachende Signaltypen.

Verfügbare Optionen:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

Ein Eintrag pro Signal-Stream, den der Monitor überwacht.

Beispiel:
company_filters
object

Globale Unternehmensfilter. Akzeptiert dieselben Parameter wie der Unternehmenssuche-Endpunkt.

Beispiel:
companies
string<uuid>[]

Liste von domain_search_id-UUIDs von Unternehmen. Alternative: domains oder linkedin_urls verwenden.

domains
string[]

Liste von Unternehmensdomains. Alternative zu companies.

linkedin_urls
string<uri>[]

Liste von LinkedIn-Unternehmens-URLs. Alternative zu companies.

is_company_enrichment
boolean

Ob Unternehmensdaten angereichert werden sollen.

is_people_enrichment
boolean

Ob Personendaten angereichert werden sollen.

people_enrichment_configs
object[]

Array von Personenanreicherungs-Ebenen. Enthält max_people_to_return (1-25), people_contact_types (siehe Redeem) und filters (siehe Personensuche).

Beispiel:
destination_type
enum<string>

Typ des Zustellziels.

Verfügbare Optionen:
webhook,
email,
sequences
frequency_minute
integer

Auslösefrequenz in Minuten. Min: 0, Max: 10080.

Erforderlicher Bereich: 0 <= x <= 10080
max_failure_trigger
integer

Maximale Anzahl aufeinanderfolgender Fehlschläge vor der Pausierung. Min: 1, Max: 10.

Erforderlicher Bereich: 1 <= x <= 10
max_daily_trigger
integer

Maximale Anzahl von Auslösungen pro Tag. Min: 0, Max: 86400.

Erforderlicher Bereich: 0 <= x <= 86400
max_records_per_trigger
integer

Steuert die maximale Anzahl der pro Auslösung zugestellten Datensätze. Niedrigere Werte verringern die Payload-Größe pro Zustellung, was für große Ergebnismengen oder ratenbegrenzte Integrationen empfohlen wird. Min: 1, Max: 100, Standard: 25. Weitere Hinweise finden Sie unter Webhooks einrichten.

Erforderlicher Bereich: 1 <= x <= 100
notification_email
string<email>

E-Mail für Fehlerbenachrichtigungen.

max_retry_per_trigger
integer

Maximale Wiederholungen pro Auslösung. Min: 0, Max: 3.

Erforderlicher Bereich: 0 <= x <= 3
retry_delay_second
integer

Verzögerung zwischen Wiederholungen in Sekunden. Min: 1, Max: 5.

Erforderlicher Bereich: 1 <= x <= 5

Antwort

Erfolgreiche Antwort mit den Webhook-Validierungsergebnissen — der Ziel-Konfiguration und den Test-Request-/Response-Payloads. Bei einem Webhook-Fehler antwortet der Endpunkt mit 400 (MONITOR_WEBHOOK_URL_INVALID) und der Antwort des Webhooks in den Fehlerdetails.

data
object