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

# Send a test event

> Queues a `webhook.test` delivery with a sample order, whatever events the endpoint subscribes to. Disabled endpoints refuse it.



## OpenAPI

````yaml /api-reference/openapi/seller-v1.yaml post /v1/seller/webhooks/{id}/test
openapi: 3.1.0
info:
  description: >-
    Read and manage your store's orders, delivery commands, servers and
    webhooks.
  title: Gamecart Seller API
  version: 1.0.0
servers:
  - url: https://api.gamecart.gg
security: []
tags:
  - description: The store behind the API token.
    name: Store
  - description: Orders and the actions on them.
    name: Orders
  - description: Internal notes on orders. Only the seller sees them.
    name: Order notes
  - description: The delivery command queue.
    name: Commands
  - description: >-
      Run the queue from your own executor, with the same protocol as the
      official connectors.
    name: Command execution
  - description: Game servers that receive delivery commands.
    name: Servers
  - description: Webhook endpoints and their deliveries.
    name: Webhooks
paths:
  /v1/seller/webhooks/{id}/test:
    post:
      tags:
        - Webhooks
      summary: Send a test event
      description: >-
        Queues a `webhook.test` delivery with a sample order, whatever events
        the endpoint subscribes to. Disabled endpoints refuse it.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookDelivery'
          description: The queued delivery.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PlanRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - apiToken:
            - webhooks:write
components:
  schemas:
    UUID:
      format: uuid
      pattern: >-
        [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
      type: string
    WebhookDelivery:
      description: One event sent to one endpoint, with its retry state.
      properties:
        attemptCount:
          examples:
            - 1
          format: int32
          type: integer
        createdAt:
          $ref: '#/components/schemas/Instant'
          examples:
            - '2026-09-25T13:05:00.000Z'
          type: string
        eventId:
          description: Stable per event and order; use it to drop duplicates.
          examples:
            - order.payment_approved:GC-7K9Q2X
          type: string
        eventType:
          examples:
            - order.payment_approved
          type: string
        id:
          $ref: '#/components/schemas/UUID'
          examples:
            - 7c9e6679-7425-40de-944b-e07fc1f90ae7
          type: string
        lastError:
          description: Sanitized failure of the last attempt.
          examples:
            - TRANSPORT_TIMEOUT
          type: string
        lastStatusCode:
          description: HTTP status of the last attempt.
          examples:
            - 200
          format: int32
          type: integer
        nextAttemptAt:
          $ref: '#/components/schemas/Instant'
          description: When the next retry runs.
          type: string
        payload:
          description: Exact body that was signed and sent. Detail responses only.
          type: object
        status:
          $ref: '#/components/schemas/WebhookDeliveryStatus'
          description: '`PENDING` until a 2xx arrives or the attempts run out.'
          examples:
            - SENT
          type: string
      type: object
    Instant:
      examples:
        - '2022-03-10T16:15:50.000Z'
      format: date-time
      type: string
    WebhookDeliveryStatus:
      enum:
        - PENDING
        - SENT
        - FAILED
      type: string
    Problem:
      description: >-
        RFC 9457 problem details. Decide on `status` and `code`; `detail` is
        localized text for people.
      properties:
        code:
          description: Stable machine-readable code.
          examples:
            - ORDER_NOT_FOUND
          type: string
        detail:
          examples:
            - Order not found.
          type: string
        errors:
          description: Field errors of a validation failure.
          items:
            $ref: '#/components/schemas/FieldProblem'
          type: array
        instance:
          examples:
            - /v1/seller/orders/GC-NOPE
          type: string
        requiredScope:
          description: Scopes the operation needs. Present on `INTEGRATION_SCOPE_MISSING`.
          examples:
            - - orders:read
              - orders:buyer:read
          items:
            type: string
          type: array
        retryAfterSeconds:
          description: Seconds to wait. Present on `RATE_LIMIT_ERROR`.
          examples:
            - 17
          type: integer
        status:
          examples:
            - 404
          type: integer
        title:
          examples:
            - Not Found
          type: string
        traceId:
          description: Identifier to quote when contacting support.
          examples:
            - ede70d1d-66d8-4af7-9a4e-a8775b047380
          type: string
        type:
          examples:
            - about:blank
          type: string
      type: object
    FieldProblem:
      properties:
        code:
          description: Message key of the violation.
          examples:
            - validation.required
          type: string
        field:
          examples:
            - content
          type: string
        message:
          examples:
            - This field is required.
          type: string
      type: object
  responses:
    Unauthorized:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: The token is missing or invalid (`INVALID_INTEGRATION_TOKEN`).
    PlanRequired:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: The store's plan does not include API access (`PLAN_FEATURE_REQUIRED`).
    Forbidden:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: >-
        The token lacks a required scope (`INTEGRATION_SCOPE_MISSING`);
        `requiredScope` lists every scope the operation needs.
    NotFound:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: >-
        The resource does not exist in this store. A resource of another store
        answers the same way.
    Conflict:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: The resource is in a state that does not allow the action.
    RateLimited:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      description: The rate limit for this route was reached (`RATE_LIMIT_ERROR`).
      headers:
        Retry-After:
          description: Seconds until the next accepted call.
          schema:
            type: integer
  securitySchemes:
    apiToken:
      description: >-
        API token created in the dashboard under Integrations > API. Tokens
        start with `gci_`.
      scheme: bearer
      type: http

````