Inbox filters
Create an inbox filter
POST
/filtersHides matching emails from the main inbox without moving them: they stay in INBOX, are listed by GET /emails?filtered=only, and remain visible in any view whose criteria match them.
Addresses and domains are stored lowercase; a leading @ on a domain is dropped. A label filter must reference a label of the workspace.
Authorization
apiKey AuthorizationBearer <token>
Send your key as Authorization: Bearer mk_…. Session cookies are never accepted on this surface.
In: header
Header Parameters
Idempotency-Key?string
A unique value per operation, such as a UUID. Replays the stored response for 24h. Reusing a key with a different body returns 409.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/filters" \ -H "Authorization: Bearer $MAYLEE_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "type": "domain", "value": "newsletter.example.com" }'{ "filter": { "createdAt": "2026-07-15T08:30:00.000Z", "id": "cmfl1a2b3c4d5e6f7g8h9i0j", "label": null, "type": "domain", "updatedAt": "2026-07-15T08:30:00.000Z", "value": "newsletter.example.com" }}