# Workwae API V1 API

**Canonical:** https://apis.io/apis/workwae-com/workwae-api-v1-api/  
**Provider:** workwae-com — https://apis.io/providers/workwae-com/  
**Base URL:** https://api.workwae.com  
**Documentation:** https://workwae.com/quickstart

Workwae API V1 API is one of 2 APIs that [workwae-com](https://apis.io/providers/workwae-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Email, calendar and contacts sync for Gmail and Microsoft 365 accounts, and email sync for

## Operations (60 of 141)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/accounts` | List accounts |
| POST | `/v1/accounts` | Connect an account from an existing refresh token |
| GET | `/v1/accounts/{accountId}` | Get an account |
| PATCH | `/v1/accounts/{accountId}` | Update an account |
| DELETE | `/v1/accounts/{accountId}` | Delete an account |
| POST | `/v1/accounts/{accountId}/sync` | Sync an account now |
| POST | `/v1/accounts/{accountId}/tokens` | Mint an account-scoped token |
| POST | `/v1/accounts/{accountId}/mcp-keys` | Mint an MCP key for an account's user |
| GET | `/v1/accounts/{accountId}/mcp-keys` | List an account's MCP keys |
| DELETE | `/v1/accounts/{accountId}/mcp-keys/{keyId}` | Revoke an MCP key |
| GET | `/v1/accounts/{accountId}/mailboxes` | List mailboxes (folders or labels) |
| POST | `/v1/accounts/{accountId}/mailboxes` | Create a mailbox (folder or label) |
| PATCH | `/v1/accounts/{accountId}/mailboxes/{mailboxId}` | Rename or move a mailbox |
| DELETE | `/v1/accounts/{accountId}/mailboxes/{mailboxId}` | Delete a mailbox |
| GET | `/v1/accounts/{accountId}/messages` | List messages, newest first |
| GET | `/v1/accounts/{accountId}/messages/{messageId}` | Get a message with its body |
| PATCH | `/v1/accounts/{accountId}/messages/{messageId}` | Change flags, move, or change labels |
| DELETE | `/v1/accounts/{accountId}/messages/{messageId}` | Delete a message |
| GET | `/v1/accounts/{accountId}/messages/{messageId}/raw` | Download the message as RFC 5322 (message/rfc822) |
| GET | `/v1/accounts/{accountId}/messages/{messageId}/attachments/{attachmentId}` | Download an attachment |
| GET | `/v1/accounts/{accountId}/search/messages` | Search messages |
| GET | `/v1/accounts/{accountId}/threads` | List threads, latest activity first |
| GET | `/v1/accounts/{accountId}/threads/{threadId}` | Get a thread with its messages, oldest first |
| PATCH | `/v1/accounts/{accountId}/threads/{threadId}` | Mark a thread read or unread, or move it |
| DELETE | `/v1/accounts/{accountId}/threads/{threadId}` | Move a thread to Trash |
| POST | `/v1/accounts/{accountId}/drafts` | Create a draft |
| PUT | `/v1/accounts/{accountId}/drafts/{messageId}` | Replace a draft's content |
| DELETE | `/v1/accounts/{accountId}/drafts/{messageId}` | Delete a draft |
| POST | `/v1/accounts/{accountId}/drafts/{messageId}/send` | Send a draft |
| POST | `/v1/accounts/{accountId}/outbox` | Send a message |
| GET | `/v1/accounts/{accountId}/outbox` | List queued and recent sends, newest first |
| GET | `/v1/accounts/{accountId}/outbox/{outboxId}` | Get a send |
| DELETE | `/v1/accounts/{accountId}/outbox/{outboxId}` | Cancel a queued send |
| PATCH | `/v1/accounts/{accountId}/outbox/{outboxId}` | Reschedule a queued send |
| GET | `/v1/accounts/{accountId}/outbox/{outboxId}/tracking` | List a send's opens and clicks |
| POST | `/v1/accounts/{accountId}/mail-merges` | Send one message per recipient (mail merge) |
| GET | `/v1/templates` | List templates |
| POST | `/v1/templates` | Create a template |
| GET | `/v1/templates/{templateId}` | Get a template |
| PATCH | `/v1/templates/{templateId}` | Update a template |
| DELETE | `/v1/templates/{templateId}` | Delete a template |
| POST | `/v1/template-renders` | Render a template without sending |
| GET | `/v1/suppressions` | List suppression lists |
| POST | `/v1/suppressions` | Create a suppression list |
| PATCH | `/v1/suppressions/{listId}` | Update a suppression list |
| DELETE | `/v1/suppressions/{listId}` | Delete a suppression list |
| GET | `/v1/suppressions/{listId}/entries` | List suppressed addresses |
| POST | `/v1/suppressions/{listId}/entries` | Suppress addresses |
| DELETE | `/v1/suppressions/{listId}/entries/{address}` | Release an address |
| GET | `/v1/suppression-reviews` | List opt-outs to review |
| POST | `/v1/suppression-reviews/{reviewId}/approve` | Approve an opt-out |
| POST | `/v1/suppression-reviews/{reviewId}/dismiss` | Dismiss an opt-out |
| GET | `/v1/accounts/{accountId}/identities` | List the addresses the account may send as |
| POST | `/v1/accounts/{accountId}/identities` | Add a custom identity |
| PATCH | `/v1/accounts/{accountId}/identities/{identityId}` | Change an identity's signature or name |
| DELETE | `/v1/accounts/{accountId}/identities/{identityId}` | Remove a custom identity |
| GET | `/v1/accounts/{accountId}/mail-settings` | Get the account's mail settings |
| PATCH | `/v1/accounts/{accountId}/mail-settings` | Update the account's mail settings |
| GET | `/v1/accounts/{accountId}/calendars` | List calendars |
| POST | `/v1/accounts/{accountId}/calendars` | Create a calendar |

…and 81 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/workwae-com/openapi/_original/workwae-com-v1-openapi.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-calendar-event-detail-schema.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-calendar-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-queued-send-schema.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-outbox-entry-schema.json
- **JSONSchema** — https://artifacts.apis.io/workwae-com/json-schema/workwae-com-scheduling-link-schema.json

## Other workwae-com APIs (1)

- [Workwae API](https://apis.io/apis/workwae-com/workwae-api/)

---

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