---
title: "Send an event"
method: POST
path: "/topics/{topic_slug}/events"
tags: ["events"]
---

# Send an event

`POST /topics/{topic_slug}/events`

Send an event to Sailhouse

## Path parameters

- `topic_slug` string, required

## Request body

- SendEventRequest
  - `data` object, required — The event data, as a JSON object
  - `metadata` object — Additional metadata for the event
  - `send_at` string, nullable — RFC3339 formatted string for when the event should be sent to subscriptions
  - `wait_group_instance_id` string, nullable — ID of the wait group instance to which this event should be added to

## Response `200`

Success

- SendEventResponse
  - `id` string, required — The ID of the event that was sent.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2024-02-10** `a2d864f3a8db` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sailhouse/apis/sailhouse-api/changes/topics/:topic_slug/events/post.md)

---

[API](https://skmtc.dev/sailhouse/apis/sailhouse-api.md) · [All operations](https://skmtc.dev/sailhouse/apis/sailhouse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sailhouse/sailhouse-api/revisions/43535eb89833/schema)