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

# Send a Test Event

> Send a synthetic event to check your receiver.

The endpoint must be verified and subscribed to the event type, or the request returns `409 WEBHOOK_TEST_BLOCKED`.

**Send now.** `{ "type": "payment.succeeded" }` sends a signed example payload right away and returns your receiver's `http_status`, with `accepted: true` for a `2xx` response. Nothing is stored.

**Queue.** `{ "type": "card_enrollment.completed", "queued": true }` checks the queued delivery path. The endpoint must also be enabled. The response is `{ "queued": true, "event_id": "evt_…" }`. The test event then appears in [List deliveries](https://docs.prava.space/api-reference/webhooks/list-deliveries.md) and [List events](https://docs.prava.space/api-reference/webhooks/list-events.md).

Test payloads have `"test": true` and example data. They check delivery to your receiver, not enrollment or payment behavior.

Returns `422 WEBHOOK_RECEIVER_UNAVAILABLE` when the receiver can't be reached securely. See [Testing webhooks](https://docs.prava.space/webhooks/testing.md).


## OpenAPI

````yaml api-reference/openapi.json POST /v1/webhook-endpoints/{endpointId}/test
openapi: 3.1.0
info:
  title: Prava Payments API
  description: >-
    Server-side REST API for Prava Payments. All requests are authenticated with
    your secret key (sk_test_* in sandbox, sk_live_* in production).
  version: 1.0.0
servers:
  - url: https://sandbox.api.prava.space
    description: Sandbox
  - url: https://api.prava.space
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/webhook-endpoints/{endpointId}/test:
    post:
      tags:
        - Webhooks
      summary: POST /v1/webhook-endpoints/{endpointId}/test
      description: >-
        Gated preview; application and environment are derived from the secret
        key. See the Webhooks guide for delivery and signing contracts.
      parameters:
        - name: endpointId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - type
              properties:
                type:
                  type: string
                  enum:
                    - payment.credentials_ready
                    - payment.succeeded
                    - payment.failed
                    - card_enrollment.completed
                    - card_enrollment.failed
                    - card_enrollment.cancelled
                    - card_enrollment.expired
                    - mandate.created
                    - mandate.creation_failed
                    - mandate.creation_cancelled
                    - mandate.creation_expired
                    - mandate.paused
                    - mandate.resumed
                    - mandate.cancelled
                    - mandate.expired
                    - quote.request_failed
                queued:
                  type: boolean
                  default: false
                  description: >-
                    Use queued delivery on an active endpoint; synthetic,
                    non-financial data
      responses:
        '200':
          description: >-
            Successful operation; endpoints never include stored signing
            secrets.
          content:
            application/json:
              schema:
                oneOf:
                  - title: Sent now
                    type: object
                    required:
                      - http_status
                      - accepted
                    properties:
                      http_status:
                        type: integer
                        description: Your receiver's HTTP status.
                      accepted:
                        type: boolean
                        description: '`true` when the status was 2xx.'
                  - title: Queued
                    type: object
                    required:
                      - queued
                      - event_id
                    properties:
                      queued:
                        type: boolean
                        const: true
                      event_id:
                        type: string
                        description: The test event's ID. Track it in List deliveries.
        '400':
          description: Invalid input or cursor
        '404':
          description: Resource not found in this application
        '409':
          description: Verification, idempotency, or endpoint state conflict
        '422':
          description: >-
            WEBHOOK_RECEIVER_UNAVAILABLE: public receiver DNS, HTTPS or
            availability failure; safe actionable error without receiver
            diagnostics
        '503':
          description: Preview disabled or temporarily unavailable
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your secret key: sk_test_* (sandbox) or sk_live_* (production).'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.