Emails

List Emails

Returns a list of emails for a specific inbox. All email endpoints are scoped to a particular inbox.

GET /inboxes/{inboxId}/emails

curl -H "Authorization: Bearer apk_your_api_key_here" \
     "https://api.emailhook.com/v1/inboxes/ibx_123/emails?limit=10&isRead=false"

Query Parameters

• limit - Number of emails to return (1-100, default: 25)
• cursor - Cursor for pagination
• isRead - Filter by read status (true/false)
• since - ISO datetime to filter emails received after
• until - ISO datetime to filter emails received before
• sort - Sort order (receivedAt, -receivedAt, createdAt, -createdAt, updatedAt, -updatedAt)

Get Email

Retrieves a specific email by ID with full content and attachments from a specific inbox.

GET /inboxes/{inboxId}/emails/{emailId}

curl -H "Authorization: Bearer apk_your_api_key_here" \
     https://api.emailhook.com/v1/inboxes/ibx_123/emails/eml_123

Update Email

Updates an email's read or deleted status within a specific inbox.

PATCH /inboxes/{inboxId}/emails/{emailId}

curl -X PATCH https://api.emailhook.com/v1/inboxes/ibx_123/emails/eml_123 \
  -H "Authorization: Bearer apk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"isRead": true}'

Delete Email

Permanently deletes an email from a specific inbox.

DELETE /inboxes/{inboxId}/emails/{emailId}

curl -X DELETE https://api.emailhook.com/v1/inboxes/ibx_123/emails/eml_123 \
  -H "Authorization: Bearer apk_your_api_key_here"