> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Monitor Validate Webhook > Validate a monitor's webhook endpoint configuration. ## OpenAPI ````yaml en-openapi POST /monitors/webhook/validate openapi: 3.0.0 info: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/en/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/en/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace profile information and usage statistics - name: Enrichment description: Enrich people and company records with detailed B2B data - name: Lookalike description: Find companies similar to a given company - name: Search description: Search for people, companies, jobs, news, and advertisements with filters - name: Lookup description: >- Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies - name: LinkedIn description: Look up people and company data via LinkedIn profile URLs - name: Redeem description: Redeem credits to unlock people contact details (single and batch) - name: Channels description: Manage outreach channel templates (create, update, delete, list) - name: Monitor description: Create and manage data monitors with webhooks, statistics, and processing - name: Filters description: >- Retrieve available filter values for search parameters (technologies, locations, verticals, etc.) externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /monitors/webhook/validate: post: tags: - Monitor summary: Validate monitor webhook description: Validate a monitor's webhook endpoint configuration. operationId: monitors_validate_webhook parameters: [] requestBody: required: true content: application/json: schema: type: object properties: monitor_id: type: string format: uuid description: >- Unique identifier of an existing monitor to test. Optional for testing new configurations. name: type: string description: Name of the monitor. description: type: string description: Description of the monitor. detection_mode: type: string description: Detection mode. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements description: Types of signals to monitor. signal_filters: type: array items: type: object description: >- Array of signal filter objects. Each object has `signal_type` and `filters`. See [Job Search](/en/api-reference/endpoint/companies/job_search), [News Search](/en/api-reference/endpoint/companies/news_search), or [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search) for filter parameters. example: - filters: locations: - US signal_type: jobs - filters: locations: - US signal_type: news - filters: target_locations: - US signal_type: advertisements company_filters: type: object description: >- Global company filters. Accepts the same parameters as the [Company Search](/en/api-reference/endpoint/companies/search) endpoint. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- List of company domain_search_id UUIDs. Alternative: use `domains` or `linkedin_urls`. domains: type: array items: type: string description: List of company domains. Alternative to `companies`. linkedin_urls: type: array items: type: string format: uri description: List of LinkedIn company URLs. Alternative to `companies`. is_company_enrichment: type: boolean description: Whether to enrich company data. is_people_enrichment: type: boolean description: Whether to enrich people data. people_enrichment_configs: type: array items: type: object description: >- Array of people enrichment layers. Contains `max_people_to_return` (1-25), `people_contact_types` (see [Redeem](/en/api-reference/endpoint/redeem/people)), and `filters` (see [People Search](/en/api-reference/endpoint/people/search)). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: Delivery destination type. enum: - webhook - email - sequences destination_config: type: object description: >- Configuration for the destination. For webhook: requires `webhook_url` (string), optional `headers` (object) and `body` (object). For email: requires `email` (string). For sequences: requires `sequence_identifier` (string) and `record_type` (string). example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: 'Trigger frequency in minutes. Min: 0, Max: 10080.' minimum: 0 maximum: 10080 max_failure_trigger: type: integer description: >- Maximum consecutive failures before pausing. Min: 1, Max: 10. minimum: 1 maximum: 10 max_daily_trigger: type: integer description: 'Maximum triggers per day. Min: 0, Max: 86400.' minimum: 0 maximum: 86400 max_records_per_trigger: type: integer description: >- Controls the maximum number of records delivered per trigger. Lower values reduce payload size per delivery, which is recommended for large result sets or rate-limited integrations. Min: 1, Max: 100, Default: 25. See [Setting up Webhooks](/en/developer-guides/setting-up-webhooks) for guidance. minimum: 1 maximum: 100 notification_email: type: string format: email description: Email for failure notifications. max_retry_per_trigger: type: integer description: 'Maximum retries per trigger. Min: 0, Max: 3.' minimum: 0 maximum: 3 retry_delay_second: type: integer description: 'Delay between retries in seconds. Min: 1, Max: 5.' minimum: 1 maximum: 5 profile_id: $ref: '#/components/schemas/profile_id' required: - destination_type - destination_config responses: '200': description: >- Successful response containing the webhook validation results, including the destination configuration and the test request/response payloads. content: application/json: schema: type: object properties: data: type: object properties: destination_config: type: object description: The destination configuration that was tested. request_payload: type: object description: >- The request payload sent to the webhook during validation. response_payload: type: object description: The response payload received from the webhook. response_status_code: type: integer description: HTTP status code returned by the webhook. is_success: type: boolean description: Whether the webhook validation was successful. example: data: destination_config: webhook_url: https://usewebhook.com/example headers: X-Custom-Auth: your-token body: source: pubrio request_payload: monitor: monitor_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: My Monitor detection_mode: signal_first signal_types: - jobs - news - advertisements signal_filters: - ... company_filters: ...: ... is_company_enrichment: true is_people_enrichment: true people_enrichment_configs: - ... metadata: total_signals: 3 total_companies: 1 total_people: 0 triggered_at: '2026-04-05T22:43:06.973Z' signals: - signal_type: jobs signal: signal_type: jobs job_search_id: ... companies: - ... companies: - ... - ... source: pubrio response_payload: OK '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: profile_id: type: integer description: >- Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking. Check out `user details` endpoints under the Profile tab for more information. responses: general_error: description: >- Bad request. The request was malformed or contained invalid parameters. Check the error code and message for details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate limit exceeded. Too many requests were made in a given time period. Retry after the rate limit window resets. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Internal server error. An unexpected error occurred on the server. Contact support if the error persists. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section. in: header ````