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

# Verify webhook connectivity

> Verify that your configured public webhook endpoint is reachable during platform setup. This endpoint is a support verification helper, not the incoming-review business callback contract.



## OpenAPI

````yaml /openapi/blips-public-reference.yaml post /webhooks/test
openapi: 3.1.0
info:
  title: BLIPS Public Reference API
  version: '2026-04-08'
  description: >-
    Public OpenAPI 3.1 subset for the first BLIPS Mintlify API Reference and
    Playground release. This document is bound to the confirmed Public Test
    Backend at https://public-test.blips.network, includes only the approved
    first-release public endpoints, uses only internal `$ref` values, and
    excludes callback-only webhook documentation and operator-only surfaces.
servers:
  - url: https://public-test.blips.network
    description: >-
      Confirmed Public Test Backend ingress target for public BLIPS API
      Reference, Playground, and internet-testable Try It flows.
security:
  - BasicAuth: []
tags:
  - name: Platform Setup
    description: >-
      Bootstrap and platform configuration surfaces for establishing the public
      BLIPS integration context.
  - name: Sandbox API
    description: >-
      Sandbox-only externally displayed helper surfaces. These routes either
      adjust quote inputs or create incoming-payment review cases, but they
      always feed the existing quote or transaction families and never become
      second outward API families.
  - name: Tokens
    description: >-
      Platform-scoped API credential create, list, detail, and revoke
      operations.
  - name: Customers
    description: >-
      Customer onboarding, profile lifecycle, and PPV payment-address issuance
      surfaces.
  - name: Accounts
    description: >-
      Customer-bound internal-account and external-account surfaces kept in the
      first-layer public contract.
  - name: Same-Currency Transfers
    description: >-
      Same-currency receiver lookup plus incoming and outgoing transfer
      primitives.
  - name: Cross-Currency Transfers
    description: >-
      PPV-first receiver lookup, quote creation/readback, and quote execution
      for cross-currency flows.
  - name: Transactions
    description: Transaction readback plus bounded incoming-review decision operations.
  - name: Webhooks
    description: >-
      Webhook connectivity verification surface for the public BLIPS
      integration.
paths:
  /webhooks/test:
    post:
      tags:
        - Webhooks
      summary: Verify webhook connectivity
      description: >-
        Verify that your configured public webhook endpoint is reachable during
        platform setup. This endpoint is a support verification helper, not the
        incoming-review business callback contract.
      operationId: sendTestWebhook
      responses:
        '200':
          description: Webhook connectivity verification result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTestMvpResponse'
              examples:
                default:
                  value:
                    url: https://api.demo-bank.com/webhooks/blips
                    responseStatus: 200
                    responseBody: ok
        '400':
          description: Webhook endpoint is not configured.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTestBadRequestResponse'
              examples:
                webhookNotConfigured:
                  value:
                    status: 400
                    code: WEBHOOK_ENDPOINT_NOT_CONFIGURED
                    message: Webhook endpoint is not configured
                    details: {}
        '401':
          description: Invalid or missing API credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTestUnauthorizedResponse'
              examples:
                unauthorized:
                  value:
                    status: 401
                    code: UNAUTHORIZED
                    message: Invalid or missing API credentials
                    details: {}
        '500':
          description: Internal service error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookTestInternalErrorResponse'
              examples:
                internalServiceError:
                  value:
                    status: 500
                    code: INTERNAL_ERROR
                    message: Internal service error
                    details: {}
      security:
        - BasicAuth: []
components:
  schemas:
    WebhookTestMvpResponse:
      type: object
      additionalProperties: false
      required:
        - url
        - responseStatus
        - responseBody
      properties:
        url:
          type: string
          description: Configured webhook endpoint that was tested.
        responseStatus:
          type: integer
          description: HTTP status returned by the tested webhook endpoint.
        responseBody:
          type: string
          nullable: true
          description: >-
            Bounded preview of the response body returned by the tested
            endpoint.
    WebhookTestBadRequestResponse:
      type: object
      additionalProperties: false
      required:
        - status
        - code
        - message
        - details
      properties:
        status:
          type: integer
          description: >-
            HTTP status code returned when the webhook endpoint is not
            configured.
        code:
          type: string
          enum:
            - WEBHOOK_ENDPOINT_NOT_CONFIGURED
          description: >-
            Stable public error code for an unconfigured webhook verification
            target.
        message:
          type: string
          description: >-
            Human-readable summary of the webhook verification configuration
            failure.
        details:
          type: object
          additionalProperties: true
          description: >-
            Optional structured details for the webhook verification
            configuration failure.
    WebhookTestUnauthorizedResponse:
      type: object
      additionalProperties: false
      required:
        - status
        - code
        - message
        - details
      properties:
        status:
          type: integer
          description: >-
            HTTP status code returned for an unauthorized webhook verification
            request.
        code:
          type: string
          enum:
            - UNAUTHORIZED
          description: Stable public error code for invalid or missing API credentials.
        message:
          type: string
          description: Human-readable authorization failure summary.
        details:
          type: object
          additionalProperties: true
          description: Optional structured authorization details.
    WebhookTestInternalErrorResponse:
      type: object
      additionalProperties: false
      required:
        - status
        - code
        - message
        - details
      properties:
        status:
          type: integer
          description: >-
            HTTP status code returned for an internal webhook verification
            failure.
        code:
          type: string
          enum:
            - INTERNAL_ERROR
          description: >-
            Stable public error code for unexpected webhook verification
            failures.
        message:
          type: string
          description: Human-readable internal-error summary.
        details:
          type: object
          additionalProperties: true
          description: Optional structured internal-error details.
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: >-
        Integration-key Basic Auth (`clientId:clientSecret`) as documented in
        docs/public/AUTHENTICATION.md.

````