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

# Send test event

> Send one signed webhook.test event to the webhook URL and return the result. Requires webhooks:write. No request body. HTTP 200 means the test was attempted; inspect success for the delivery outcome. Failed tests are not retried. Tests work on disabled webhooks and do not change webhook health fields. One test per webhook is allowed every 10 seconds.



## OpenAPI

````yaml POST /v2/webhooks/{id}/test
openapi: 3.0.1
info:
  title: Tavrn Platform API
  version: 1.0.0
  description: >-
    Enterprise API for medical record retrieval: cases, retrieval requests,
    retrieved records and provider invoices, case documents, and webhook
    notifications.
  contact:
    name: Tavrn Support
    email: contact@tavrn.ai
servers:
  - url: https://enterprise.tavrn.ai
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Cases
    description: Case management operations
  - name: Documents
    description: Document upload and management
  - name: Retrieval Requests
    description: Medical record retrieval requests submitted to healthcare facilities
  - name: Requestors
    description: Multiple retrieval profiles within one organization
  - name: Webhooks
    description: Webhook registration and event notifications
paths:
  /v2/webhooks/{id}/test:
    post:
      tags:
        - Webhooks
      summary: Send test event
      description: >-
        Send one signed webhook.test event to the webhook URL and return the
        result. Requires webhooks:write. No request body. HTTP 200 means the
        test was attempted; inspect success for the delivery outcome. Failed
        tests are not retried. Tests work on disabled webhooks and do not change
        webhook health fields. One test per webhook is allowed every 10 seconds.
      operationId: sendTestWebhook
      parameters:
        - name: id
          in: path
          required: true
          description: Webhook ID
          schema:
            type: string
      responses:
        '200':
          description: Test delivery attempted (check `success`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTestResult'
        '404':
          description: >-
            Webhook not found. Ids that belong to another organization are
            indistinguishable from unknown ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: A test event was sent to this webhook less than 10 seconds ago
          headers:
            Retry-After:
              description: Seconds until you can send another test
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: rate_limited
                  message: >-
                    A test event was sent to this webhook less than 10 seconds
                    ago. Try again shortly.
components:
  schemas:
    WebhookTestResult:
      type: object
      required:
        - success
        - status_code
        - duration_ms
        - error
        - event_id
        - sent_at
      properties:
        success:
          type: boolean
          description: True if your endpoint returned a 2xx response within 5 seconds
          example: false
        status_code:
          type: integer
          nullable: true
          description: >-
            HTTP status returned by your endpoint, or null if no response was
            received
          example: 502
        duration_ms:
          type: integer
          description: Elapsed test duration, in milliseconds.
          example: 81
        error:
          type: string
          nullable: true
          description: >-
            Failure reason, or null on success. Your endpoint response body is
            not returned.
          example: HTTP 502
        event_id:
          type: string
          description: ID of the `webhook.test` event that was sent
          example: evt_test_6f1c2a9e-4b7d-4c1e-9a53-0d2f8e7b1c44
        sent_at:
          type: string
          format: date-time
          example: '2026-10-07T17:30:00.000Z'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Machine-readable error code
              example: validation_error
            message:
              type: string
              description: Human-readable error message
              example: The patient.date_of_birth field is required
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key authentication. Use format: `Authorization: Bearer
        tavrn_sk_live_...`

````