# Commune Event delivery API

**Canonical:** https://apis.io/apis/usecommune/usecommune-event-delivery-api/  
**Provider:** Commune — https://apis.io/providers/usecommune/  
**Base URL:** https://api.usecommune.com  
**Documentation:** https://api-reference.usecommune.dev/

Commune Event delivery API is one of 18 APIs that [Commune](https://apis.io/providers/usecommune/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Event delivery. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Where a newsletter's events go, and how a creator changes it. Commune hands every event it publishes to a delivery service that owns fan out, retries, signing and the delivery log, and a destination is one place that service sends them: an HTTPS endpoint, or a queue, stream or object store for a consumer that would rather not run a web server. Reading the list is an operation here, and so is reading the delivery attempt log: what was handed to which destination, what came back, and asking for one to be handed over again. Changing the destinations themselves is not. `portal-session` mints a link into the delivery service's own portal, where a creator adds an endpoint, disables one and rotates a signing secret. Asking for an attempt to be replayed is the one write here, and is the same action as the portal's retry button. Needs `webhooks` throughout, since a destination is a private endpoint of the creator's, the list of them says which systems a newsletter is wired into, and the attempt log says what those systems were told and when.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/newsletters/{newsletter}/destinations` | List where a newsletter's events go |
| GET | `/newsletters/{newsletter}/delivery-attempts` | List what was delivered where, and how it went |
| GET | `/delivery-attempts/{attempt}` | Retrieve one delivery attempt |
| POST | `/delivery-attempts/{attempt}/replay` | Send an event to a destination again |
| POST | `/newsletters/{newsletter}/portal-session` | Open the event delivery portal |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/openapi/usecommune-event-delivery-api-openapi.yml
- **Documentation** — https://api-reference.usecommune.dev/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-newsletter-stats-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-api-key-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-delivery-attempt-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-article-performance-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-article-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/usecommune/refs/heads/main/json-schema/usecommune-send-schema.json

## Other Commune APIs (12)

- [Commune Articles API](https://apis.io/apis/usecommune/usecommune-articles-api/)
- [Commune Engagement API](https://apis.io/apis/usecommune/usecommune-engagement-api/)
- [Commune Highlights API](https://apis.io/apis/usecommune/usecommune-highlights-api/)
- [Commune Messages API](https://apis.io/apis/usecommune/usecommune-messages-api/)
- [Commune Metrics API](https://apis.io/apis/usecommune/usecommune-metrics-api/)
- [Commune Newsletters API](https://apis.io/apis/usecommune/usecommune-newsletters-api/)
- [Commune Platform API](https://apis.io/apis/usecommune/usecommune-platform-api/)
- [Commune Search API](https://apis.io/apis/usecommune/usecommune-search-api/)
- [Commune Senders API](https://apis.io/apis/usecommune/usecommune-senders-api/)
- [Commune Sends API](https://apis.io/apis/usecommune/usecommune-sends-api/)
- [Commune Subscriber tags API](https://apis.io/apis/usecommune/usecommune-subscriber-tags-api/)
- [Commune Subscribers API](https://apis.io/apis/usecommune/usecommune-subscribers-api/)

## Tags

Event delivery

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/usecommune/usecommune-event-delivery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/usecommune/.