# Honeycomb Recipients API

**Canonical:** https://apis.io/apis/honeycomb-io/honeycomb-io-recipients-api/  
**Provider:** Honeycomb — https://apis.io/providers/honeycomb-io/  
**Base URL:** https://api.honeycomb.io  
**Documentation:** https://docs.honeycomb.io/api/tag/Events

Honeycomb Recipients API is one of 21 APIs that [Honeycomb](https://apis.io/providers/honeycomb-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Recipients. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Honeycomb Recipients allow you to define and manage the Recipients that will get notified by a Trigger or Burn Alert. The types of Recipients supported are: PagerDuty, Email, Webhook, Microsoft Teams, and Slack. ## Authorization The API key must have the **Manage Recipients** permission. Recipients are team-wide and NOT environment-specific. API Keys with the **Manage Recipients** permission can modify recipients used by ALL environments for a given team. Learn more about [API keys here](https://docs.honeycomb.io/configure/environments/manage-api-keys/).

## Machine-readable artifacts (21)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/honeycomb-io/refs/heads/main/openapi/honeycomb-io-recipients-api-openapi.yml
- **Documentation** — https://docs.honeycomb.io/api/tag/Events
- **Documentation** — https://docs.honeycomb.io/api/tag/Datasets
- **Documentation** — https://docs.honeycomb.io/api/tag/Dataset-Definitions
- **Documentation** — https://docs.honeycomb.io/api/tag/Columns
- **Documentation** — https://docs.honeycomb.io/api/tag/Calculated-Fields
- **Documentation** — https://docs.honeycomb.io/api/tag/Queries
- **Documentation** — https://docs.honeycomb.io/api/tag/Query-Data
- **Documentation** — https://docs.honeycomb.io/api/tag/Query-Annotations
- **Documentation** — https://docs.honeycomb.io/api/tag/Boards
- **Documentation** — https://docs.honeycomb.io/api/tag/Triggers
- **Documentation** — https://docs.honeycomb.io/api/tag/Recipients
- **Documentation** — https://docs.honeycomb.io/api/tag/SLOs
- **Documentation** — https://docs.honeycomb.io/api/tag/Burn-Alerts
- **Documentation** — https://docs.honeycomb.io/api/tag/Reporting
- **Documentation** — https://docs.honeycomb.io/api/tag/Markers
- **Documentation** — https://docs.honeycomb.io/api/tag/Marker-Settings
- **Documentation** — https://docs.honeycomb.io/api/tag/Service-Maps
- **Documentation** — https://docs.honeycomb.io/api/tag/Auth
- **Documentation** — https://docs.honeycomb.io/api/tag/Key-Management
- **Documentation** — https://docs.honeycomb.io/api/tag/Environments

## Other Honeycomb APIs (12)

- [Honeycomb Auth API](https://apis.io/apis/honeycomb-io/honeycomb-io-auth-api/)
- [Honeycomb Boards API](https://apis.io/apis/honeycomb-io/honeycomb-io-boards-api/)
- [Honeycomb Burn Alerts API](https://apis.io/apis/honeycomb-io/honeycomb-io-burn-alerts-api/)
- [Honeycomb Calculated Fields API](https://apis.io/apis/honeycomb-io/honeycomb-io-calculated-fields-api/)
- [Honeycomb Columns API](https://apis.io/apis/honeycomb-io/honeycomb-io-columns-api/)
- [Honeycomb Dataset Definitions API](https://apis.io/apis/honeycomb-io/honeycomb-io-dataset-definitions-api/)
- [Honeycomb Datasets API](https://apis.io/apis/honeycomb-io/honeycomb-io-datasets-api/)
- [Honeycomb Environments API](https://apis.io/apis/honeycomb-io/honeycomb-io-environments-api/)
- [Honeycomb Events API](https://apis.io/apis/honeycomb-io/honeycomb-io-events-api/)
- [Honeycomb Key Management API](https://apis.io/apis/honeycomb-io/honeycomb-io-key-management-api/)
- [Honeycomb Kinesis Events API](https://apis.io/apis/honeycomb-io/honeycomb-io-kinesis-events-api/)
- [Honeycomb Marker Settings API](https://apis.io/apis/honeycomb-io/honeycomb-io-marker-settings-api/)

## Tags

Recipients

---

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