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

# Send a test event

> POSTs a signed `webhook.test` event to the endpoint right now and waits up to 10s for the response, so you can verify your handler and signature check end to end. The attempt is recorded as an event and a delivery like any other, but is never retried.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/webhooks/endpoints/{id}/test
openapi: 3.1.0
info:
  title: Chipper Platform API
  version: '2026-02-20'
  description: >-
    Payouts, collections, and FX across African rails — bank, mobile money, and
    stablecoins — through one API.
servers:
  - url: https://sandbox-api.platform.chipper.ai
    description: Sandbox (sk_test_ keys — simulated rails, no real money)
  - url: https://api.platform.chipper.ai
    description: Production (sk_live_ keys)
security:
  - bearerAuth: []
paths:
  /v1/webhooks/endpoints/{id}/test:
    post:
      tags:
        - Webhooks
      summary: Send a test event
      description: >-
        POSTs a signed `webhook.test` event to the endpoint right now and waits
        up to 10s for the response, so you can verify your handler and signature
        check end to end. The attempt is recorded as an event and a delivery
        like any other, but is never retried.
      parameters:
        - schema:
            type: string
            description: Webhook endpoint id.
            example: whe_k3m9x2pq7vn4t8wz1bcd
          required: true
          name: id
          in: path
      responses:
        '200':
          description: >-
            Result of the test delivery. Returned with 200 even when your
            endpoint failed — check `success`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  test:
                    type: object
                    properties:
                      success:
                        type: boolean
                        description: True when your endpoint returned 2xx.
                      statusCode:
                        type:
                          - integer
                          - 'null'
                        description: Null if the connection failed.
                        example: 200
                      error:
                        type:
                          - string
                          - 'null'
                        description: >-
                          Response body snippet or network error when not
                          successful.
                      deliveryId:
                        type: string
                        example: whd_x4n7q2vm8kp3r9zt5wbc
                    required:
                      - success
                      - statusCode
                      - error
                      - deliveryId
                required:
                  - test
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: unauthorized
                message: Invalid API key
                requestId: req_q7vei435zifs51ia0lqr
        '404':
          description: No such resource in this organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: not_found
                message: Webhook endpoint not found
                requestId: req_q7vei435zifs51ia0lqr
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Stable machine-readable code.
        message:
          type: string
          description: Human-readable explanation.
        requestId:
          type: string
          description: Echoed in the x-request-id response header — quote it to support.
      required:
        - error
        - message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key: `sk_test_…` (sandbox) or `sk_live_…` (production).'

````