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

# Send event to subscription

> Manually sends an already-recorded event to this subscription — useful for a subscription that did not exist when the event first occurred.

It **queues** a delivery rather than sending synchronously. A `200` means queued, not received: track the returned `deliveryId` to find out what actually happened.



## OpenAPI

````yaml api-reference/endl-webhooks-api.json POST /api/v0/webhooks/subscriptions/{id}/send
openapi: 3.1.0
info:
  title: Endl Webhooks API
  version: '0'
  description: >-
    Register where your events go, inspect what happened to each delivery, and
    read the PULL feed.


    Every endpoint returns the standard Endl response envelope and requires the
    `webhooks` permission — the PULL feed additionally requires `events`.
servers:
  - url: https://qa-api.endl.xyz
    description: QA
security:
  - apiKey: []
tags:
  - name: Subscriptions
    description: Register and manage the endpoints that receive your events.
  - name: Deliveries
    description: Inspect and retry individual delivery attempts.
  - name: Events
    description: Read events from the PULL feed.
paths:
  /api/v0/webhooks/subscriptions/{id}/send:
    parameters:
      - $ref: '#/components/parameters/SubscriptionId'
    post:
      tags:
        - Subscriptions
      summary: Send event to subscription
      description: >-
        Manually sends an already-recorded event to this subscription — useful
        for a subscription that did not exist when the event first occurred.


        It **queues** a delivery rather than sending synchronously. A `200`
        means queued, not received: track the returned `deliveryId` to find out
        what actually happened.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - eventId
              properties:
                eventId:
                  type: string
                  maxLength: 64
                  description: The event id — the value delivered as `X-WEBHOOK-EVENT-ID`.
            example:
              eventId: evt_9f1a4c7b2e08
      responses:
        '200':
          description: Queued for delivery.
          content:
            application/json:
              example:
                code: 200
                message: Event queued for delivery
                status: SUCCESS
                data:
                  message: >-
                    queued for delivery — this does not guarantee immediate
                    receipt at the endpoint
                  deliveryId: 4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44
                errors: []
        '400':
          description: >-
            Bad `eventId`, a PULL subscription, a send rate limit, or missing
            permission.
        '401':
          description: Authentication failed.
        '404':
          description: Subscription or event not found.
        '409':
          description: Conflicting delivery.
        '503':
          description: Endl could not verify the credential right now.
components:
  parameters:
    SubscriptionId:
      name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
      description: The subscription's UUID.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: API-KEY
      description: >-
        Your partner API key. Requires the `webhooks` permission, or `events`
        for the PULL feed.

````