List subscribable event types

[
  {
    "name": "shipment.created",
    "description": "Fires when a new shipment is created in the system.",
    "payload_schema": {
      "type": "object",
      "properties": {
        "shipment_id": {
          "type": "string",
          "description": "Unique identifier for the shipment",
          "example": "shp_1234567890abcdef"
        },
        "origin": {
          "type": "string",
          "description": "Origin location code",
          "example": "LAX"
        },
        "destination": {
          "type": "string",
          "description": "Destination location code",
          "example": "JFK"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when the shipment was created",
          "example": "2024-06-01T12:00:00Z"
        },
        "status": {
          "type": "string",
          "description": "Current status of the shipment",
          "enum": [
            "pending",
            "in_transit",
            "delivered",
            "cancelled"
          ],
          "example": "pending"
        }
      },
      "required": [
        "shipment_id",
        "origin",
        "destination",
        "created_at",
        "status"
      ]
    }
  },
  {
    "name": "shipment.delivered",
    "description": "Fires when a shipment has been successfully delivered.",
    "payload_schema": {
      "type": "object",
      "properties": {
        "shipment_id": {
          "type": "string",
          "description": "Unique identifier for the shipment",
          "example": "shp_1234567890abcdef"
        },
        "delivered_at": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when the shipment was delivered",
          "example": "2024-06-05T15:30:00Z"
        },
        "receiver_name": {
          "type": "string",
          "description": "Name of the person who received the shipment",
          "example": "John Doe"
        },
        "condition": {
          "type": "string",
          "description": "Condition of the shipment upon delivery",
          "enum": [
            "intact",
            "damaged",
            "missing_items"
          ],
          "example": "intact"
        }
      },
      "required": [
        "shipment_id",
        "delivered_at",
        "receiver_name",
        "condition"
      ]
    }
  },
  {
    "name": "invoice.paid",
    "description": "Fires when an invoice has been paid successfully.",
    "payload_schema": {
      "type": "object",
      "properties": {
        "invoice_id": {
          "type": "string",
          "description": "Unique identifier for the invoice",
          "example": "inv_9876543210fedcba"
        },
        "amount": {
          "type": "number",
          "format": "float",
          "description": "Amount paid",
          "example": 1250.75
        },
        "currency": {
          "type": "string",
          "description": "Currency code",
          "example": "USD"
        },
        "paid_at": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when the payment was made",
          "example": "2024-06-03T09:45:00Z"
        },
        "payment_method": {
          "type": "string",
          "description": "Method used for payment",
          "enum": [
            "credit_card",
            "bank_transfer",
            "paypal"
          ],
          "example": "credit_card"
        }
      },
      "required": [
        "invoice_id",
        "amount",
        "currency",
        "paid_at",
        "payment_method"
      ]
    }
  }
]

Catalog of event type names you can pass in event_types when registering an endpoint. Each entry includes a JSON Schema for the envelope’s data field — use it to generate types or validate incoming payloads. Trigger the event in the platform to see a real delivery in the endpoint’s log.

Authentication: Supports API key and bearer token authentication.

Catalog of event type names you can pass in `event_types` when registering an endpoint. Each entry includes a JSON Schema for the envelope's `data` field — use it to generate types or validate incoming payloads. Trigger the event in the platform to see a real delivery in the endpoint's log. **Authentication:** Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful Response

namestring

Event type identifier, e.g. ‘elp_test.scored’

descriptionstring

Human-readable summary of when this event fires.

payload_schemamap from strings to any

JSON Schema describing the envelope’s data field for this event.

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

$	curl https://tryenvoy.ai/api/v1/webhooks/event-types \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Headers

Response

Errors