# Hookdeck Tenants API

**Canonical:** https://apis.io/apis/hookdeck/hookdeck-tenants-api/  
**Provider:** Hookdeck — https://apis.io/providers/hookdeck/  
**Base URL:** https://api.hookdeck.com/2025-07-01  
**Documentation:** https://hookdeck.com/docs/api

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

The API segments resources per `tenant`. A tenant represents a user/team/organization in your product. The provided value determines the tenant's ID, which can be any string representation. If your system is not multi-tenant, create a single tenant with a hard-code tenant ID upon initialization. If your system has a single tenant but multiple environments, create a tenant per environment, like `live` and `test`.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/tenants` | List Tenants |
| PUT | `/tenants/{tenant_id}` | Create or Update Tenant |
| GET | `/tenants/{tenant_id}` | Get Tenant |
| DELETE | `/tenants/{tenant_id}` | Delete Tenant |
| GET | `/tenants/{tenant_id}/portal` | Get Portal Redirect URL |
| GET | `/tenants/{tenant_id}/token` | Get Tenant JWT Token |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hookdeck/refs/heads/main/openapi/hookdeck-tenants-api-openapi.yml
- **Documentation** — https://hookdeck.com/docs/bulk-retries

## Other Hookdeck APIs (12)

- [Hookdeck Connections API](https://apis.io/apis/hookdeck/hookdeck-connections-api/)
- [Hookdeck Sources API](https://apis.io/apis/hookdeck/hookdeck-sources-api/)
- [Hookdeck Destinations API](https://apis.io/apis/hookdeck/hookdeck-destinations-api/)
- [Hookdeck Events API](https://apis.io/apis/hookdeck/hookdeck-events-api/)
- [Hookdeck Requests API](https://apis.io/apis/hookdeck/hookdeck-requests-api/)
- [Hookdeck Transformations API](https://apis.io/apis/hookdeck/hookdeck-transformations-api/)
- [Hookdeck Bookmarks API](https://apis.io/apis/hookdeck/hookdeck-bookmarks-api/)
- [Hookdeck Issues API](https://apis.io/apis/hookdeck/hookdeck-issues-api/)
- [Hookdeck Metrics API](https://apis.io/apis/hookdeck/hookdeck-metrics-api/)
- [Hookdeck Integrations API](https://apis.io/apis/hookdeck/hookdeck-integrations-api/)
- [Hookdeck Notifications API](https://apis.io/apis/hookdeck/hookdeck-notifications-api/)
- [Hookdeck Attempts API](https://apis.io/apis/hookdeck/hookdeck-attempts-api/)

## Tags

Tenants

---

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