> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a test webhook to verify URL configuration

> Sends a test POST request to a registered webhook URL to verify connectivity and proper configuration. Returns the HTTP status code and response body from the webhook endpoint.



## OpenAPI

````yaml api-reference/webhooks.yaml post /urls/test
openapi: 3.0.3
info:
  title: webhooks
  description: >-
    The Webhooks service listens to pub/sub topics for platform events and
    forwards them to client systems. It ensures clients receive real-time
    notifications via their configured webhook URLs.
  version: 1.0.0
servers:
  - url: https://webhooks.platform.arb.inc
security: []
tags:
  - name: /
  - name: urls
paths:
  /urls/test:
    post:
      tags:
        - urls
      summary: Send a test webhook to verify URL configuration
      description: >-
        Sends a test POST request to a registered webhook URL to verify
        connectivity and proper configuration. Returns the HTTP status code and
        response body from the webhook endpoint.
      operationId: testWebhookUrl
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - url
              properties:
                url:
                  type: string
                  format: uri
                  description: The registered webhook URL to test
                  example: https://api.example.com/webhooks/arb-platform
      responses:
        '200':
          description: Test webhook was sent successfully and a response was received
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    description: HTTP status code returned by the webhook endpoint
                    example: 200
                  body:
                    type: string
                    description: Raw response body returned by the webhook endpoint
                    example: '{"status":"success","message":"Webhook received"}'
        '404':
          description: The specified URL is not registered for this organization
          content:
            text/plain:
              schema:
                type: string
                example: url is not registered
        '410':
          description: >-
            Webhooks feature is only available to organizations, not individual
            users
          content:
            text/plain:
              schema:
                type: string
                example: Webhooks are only available to organizations
        '411':
          description: >-
            The webhook request timed out waiting for a response from the
            endpoint
          content:
            text/plain:
              schema:
                type: string
                example: request timed out
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````