# Forward Email Folders API

**Canonical:** https://apis.io/apis/forward-email/forward-email-folders-api/  
**Provider:** Forward Email — https://apis.io/providers/forward-email/  
**Base URL:** https://api.forwardemail.net  
**Documentation:** https://forwardemail.net/

Forward Email Folders API is one of 16 APIs that [Forward Email](https://apis.io/providers/forward-email/) 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 Folders. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Alias folders management endpoints (IMAP/POP3) >[!TIP] > Folder endpoints with a folder's path <code>/v1/folders/:path</code> as their endpoint are interchangeable with a folder's ID <code>:id</code>. This means you can refer to the folder by either its <code>path</code> or <code>id</code> value. >[!NOTE] > Unlike other API endpoints, these require [Authentication](#description/authentication) "username" equal to the alias username and "password" equal to the alias generated password as Basic Authorization headers. >[!TIP] > These endpoints provide full folder management including creation, renaming, and deletion. Folder paths can include parent folders (e.g., 'INBOX/Subfolder'), and parent folders will be created automatically if they don't exist.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/folders` | List folders |
| POST | `/v1/folders` | Create folder |
| GET | `/v1/folders/{id}` | Retrieve folder |
| PUT | `/v1/folders/{id}` | Update folder |
| DELETE | `/v1/folders/{id}` | Delete folder |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/forward-email/openapi/forward-email-folders-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-update-domain-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-smtp-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-alias-account-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-alias-input-schema.json

## Other Forward Email APIs (12)

- [Forward Email Account API](https://apis.io/apis/forward-email/forward-email-account-api/)
- [Forward Email Aliases API](https://apis.io/apis/forward-email/forward-email-aliases-api/)
- [Forward Email Calendar Events API](https://apis.io/apis/forward-email/forward-email-calendar-events-api/)
- [Forward Email Calendars API](https://apis.io/apis/forward-email/forward-email-calendars-api/)
- [Forward Email Contacts API](https://apis.io/apis/forward-email/forward-email-contacts-api/)
- [Forward Email Domains API](https://apis.io/apis/forward-email/forward-email-domains-api/)
- [Forward Email Emails API](https://apis.io/apis/forward-email/forward-email-emails-api/)
- [Forward Email Encrypt API](https://apis.io/apis/forward-email/forward-email-encrypt-api/)
- [Forward Email Invites API](https://apis.io/apis/forward-email/forward-email-invites-api/)
- [Forward Email Logs API](https://apis.io/apis/forward-email/forward-email-logs-api/)
- [Forward Email Members API](https://apis.io/apis/forward-email/forward-email-members-api/)
- [Forward Email Messages API](https://apis.io/apis/forward-email/forward-email-messages-api/)

## Tags

Folders

---

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