# Front Appeals Inbox

> Look up whether a specific email address has submitted an account ban appeal in Warp's Front Appeals inbox. Use when given an email address (e.g. from a fraud investigation) and you need to check if that user has appealed, and retrieve the content of their appeal. Returns conversations and message bodies for downstream use by other skills. Part of the fraud-bot skill suite.

- Skill: `warpdotdev/front-appeals-inbox` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add warpdotdev/front-appeals-inbox`
- Raw SKILL.md: https://api.skillmd.com/api/skills/warpdotdev/front-appeals-inbox/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: warpdotdev (https://skillmd.com/u/warpdotdev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/warpdotdev/front-appeals-inbox

---


# Front Appeals Inbox

Check if an email address has an appeal in Front, and retrieve the appeal content.

## Auth

Requires `BOT_FRONT_API_KEY` env var. The Appeals inbox ID defaults to the `YOUR_FRONT_INBOX_ID` placeholder; override it with the `FRONT_INBOX_ID` env var (or the `--inbox-id` flag).

## Usage

```bash
SKILL=.agents/skills/front-appeals-inbox/scripts/front_client.py

python3 $SKILL search-email --email user@example.com
```

Returns a JSON array of `{conversation, messages}` objects. Each entry has:
- `conversation.id` — conversation ID
- `conversation.subject` — email subject
- `conversation.status` — `open`, `archived`, `resolved`, etc.
- `conversation.created_at` — Unix timestamp
- `conversation.recipient.handle` — the appellant's email address
- `messages[].author` — sender info (`null` for inbound emails; use `conversation.recipient.handle` for the appellant's email instead)
- `messages[].text` — plain text body
- `messages[].created_at` — Unix timestamp
- `messages[].type` — `email` for inbound/outbound, `comment` for internal notes

Messages are ordered newest-first. The original appeal email is the **last** message in the array.

Empty array `[]` means no appeals found for that email.

## Setup Utility

```bash
python3 $SKILL list-inboxes  # verify inbox IDs
```