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

# Send a signed test webhook

> Creates a durable `webhook.test` event and delivery record, signs the exact outbound JSON body
with the subscription's active P-256 key, and attempts delivery to the configured endpoint.



## OpenAPI

````yaml /api-reference/openapi-integrator.json post /v1/webhooks/subscriptions/{subscription_id}/test
openapi: 3.0.3
info:
  title: Byzantine Integrator API
  description: Byzantine REST API for integrators.
  license:
    name: ''
  version: 0.2.0
servers:
  - url: https://sandbox.api.byzantine.fi
    description: Sandbox
security: []
tags:
  - name: API health
    description: Check API status.
  - name: Customer management
    description: Endpoints to create, update, and retrieve customer information.
  - name: Account management
    description: Endpoints to manage accounts, bank accounts, invitations, and user roles.
  - name: Products
    description: Endpoints to get data about products and vaults.
  - name: Transactions
    description: Endpoints to create and manage transactions.
  - name: OTP authentication
    description: Endpoints to initialize and manage user authentication with OTP.
  - name: Webhooks
    description: Integrator-managed outbound webhook subscriptions and delivery history.
paths:
  /v1/webhooks/subscriptions/{subscription_id}/test:
    post:
      tags:
        - Webhooks
      summary: Send a signed test webhook
      description: >-
        Creates a durable `webhook.test` event and delivery record, signs the
        exact outbound JSON body

        with the subscription's active P-256 key, and attempts delivery to the
        configured endpoint.
      operationId: send_test_delivery
      parameters:
        - name: X-Pubkey
          in: header
          description: >-
            Integrator's ECDSA public key (P-256 curve, compressed SEC1 format).
            Example:
            0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd
          required: true
          schema:
            type: string
        - name: X-Timestamp
          in: header
          description: >-
            Unix timestamp in seconds (UTC). Must be within tolerance window (1
            minute) to prevent replay attacks. Example: 1760375826
          required: true
          schema:
            type: string
        - name: X-Signature
          in: header
          description: >-
            ECDSA signature (DER-encoded, hex with 0x prefix). Signs the
            message: {timestamp}{METHOD}{path_and_query}{json_body}. Example:
            0x3045022100...
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Signed test webhook delivery attempted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestWebhookDeliveryResponse'
        '404':
          description: Webhook subscription not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - integrator_auth: []
components:
  schemas:
    TestWebhookDeliveryResponse:
      type: object
      required:
        - event
        - delivery
      properties:
        event:
          $ref: '#/components/schemas/WebhookEvent'
        delivery:
          $ref: '#/components/schemas/WebhookDelivery'
        attempt:
          allOf:
            - $ref: '#/components/schemas/WebhookDeliveryAttempt'
          nullable: true
    ErrorResponse:
      type: object
      required:
        - error
        - status
      properties:
        error:
          type: string
          description: Error message
          example: Resource not found
        status:
          type: integer
          format: int32
          description: HTTP status code
          example: 404
          minimum: 0
    WebhookEvent:
      type: object
      required:
        - id
        - eventType
        - sourceType
        - sourceId
        - payload
        - payloadVersion
        - sourceTransitionMetadata
        - createdAt
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
        eventType:
          type: string
        sourceType:
          type: string
        sourceId:
          type: string
        payload: {}
        payloadVersion:
          type: integer
          format: int32
        sourceTransitionMetadata: {}
        createdAt:
          type: string
          format: date-time
    WebhookDelivery:
      type: object
      required:
        - id
        - subscriptionId
        - eventId
        - status
        - attemptCount
        - createdAt
        - updatedAt
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
        subscriptionId:
          $ref: '#/components/schemas/Uuid'
        eventId:
          $ref: '#/components/schemas/Uuid'
        status:
          $ref: '#/components/schemas/WebhookDeliveryStatus'
        nextAttemptAt:
          type: string
          format: date-time
          nullable: true
        attemptCount:
          type: integer
          format: int32
        terminalReason:
          type: string
          nullable: true
        lastResponseSummary:
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    WebhookDeliveryAttempt:
      type: object
      required:
        - id
        - deliveryId
        - attemptNumber
        - outcome
        - signedAt
        - signedTimestamp
        - createdAt
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
        deliveryId:
          $ref: '#/components/schemas/Uuid'
        signingKeyId:
          allOf:
            - $ref: '#/components/schemas/Uuid'
          nullable: true
        attemptNumber:
          type: integer
          format: int32
        outcome:
          $ref: '#/components/schemas/WebhookDeliveryAttemptOutcome'
        statusCode:
          type: integer
          format: int32
          nullable: true
        error:
          type: string
          nullable: true
        latencyMs:
          type: integer
          format: int32
          nullable: true
        signedAt:
          type: string
          format: date-time
        signedTimestamp:
          type: string
        responseSummary:
          nullable: true
        actor:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
    Uuid:
      type: string
      format: uuid
      description: A UUID string
      example: 550e8400-e29b-41d4-a716-446655440000
    WebhookDeliveryStatus:
      type: string
      description: Durable webhook delivery lifecycle status stored as TEXT in Postgres.
      enum:
        - pending
        - sending
        - succeeded
        - failed
        - terminal_failed
      example: pending
    WebhookDeliveryAttemptOutcome:
      type: string
      description: Outcome of one webhook delivery attempt stored as TEXT in Postgres.
      enum:
        - succeeded
        - failed
      example: succeeded
  securitySchemes:
    integrator_auth:
      type: apiKey
      in: header
      name: X-Pubkey, X-Timestamp, X-Signature

````