> ## 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.

# Register a new webhook URL

> Registers a webhook URL to receive real-time notifications about platform events such as case closures, docket filings, and phase changes. The URL must be publicly accessible and respond to POST requests.



## OpenAPI

````yaml api-reference/webhooks.yaml post /urls/register
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/register:
    post:
      tags:
        - urls
      summary: Register a new webhook URL
      description: >-
        Registers a webhook URL to receive real-time notifications about
        platform events such as case closures, docket filings, and phase
        changes. The URL must be publicly accessible and respond to POST
        requests.
      operationId: registerWebhookUrl
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - url
              properties:
                url:
                  type: string
                  format: uri
                  description: >-
                    The publicly accessible HTTPS endpoint that will receive
                    webhook POST requests
                  example: https://api.example.com/webhooks/arb-platform
      responses:
        '200':
          description: URL successfully registered
          content:
            text/plain:
              schema:
                type: string
                example: URL successfully 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 organization has reached the maximum number of registered
            webhook URLs
          content:
            text/plain:
              schema:
                type: string
                example: limit reached
        '412':
          description: The specified URL has already been registered for this organization
          content:
            text/plain:
              schema:
                type: string
                example: url has already been registered
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````