Email Testing API

# 1. Create a test inbox
curl -X POST "https://api.mailchk.io/v1/test-inboxes" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "CI signup flow"}'

# Response:
# {
#   "id": "a1b2c3d4-...",
#   "address": "test-k9m2x7p3qr@mailchk.email",
#   "label": "CI signup flow",
#   "message_count": 0,
#   "created_at": "2026-02-15T10:00:00.000Z",
# }

# 2. Send an email to the test address from your app
# (use your own sending logic — SMTP, SendGrid, etc.)

# 3. Poll for messages
curl "https://api.mailchk.io/v1/test-inboxes/a1b2c3d4-.../messages" \
  -H "X-API-Key: YOUR_API_KEY"

# 4. Inspect a captured email
curl "https://api.mailchk.io/v1/test-inboxes/a1b2c3d4-.../messages/MSG_ID" \
  -H "X-API-Key: YOUR_API_KEY"

# GitHub Actions example — test your signup email flow
name: Email Integration Tests
on: [push]

jobs:
  test-emails:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Create test inbox
        id: inbox
        run: |
          RESPONSE=$(curl -s -X POST "https://api.mailchk.io/v1/test-inboxes" \
            -H "X-API-Key: ${{ secrets.MAILCHK_API_KEY }}" \
            -H "Content-Type: application/json" \
            -d '{"label": "CI run #${{ github.run_number }}"}')
          echo "INBOX_ID=$(echo $RESPONSE | jq -r '.id')" >> $GITHUB_OUTPUT
          echo "INBOX_ADDR=$(echo $RESPONSE | jq -r '.address')" >> $GITHUB_OUTPUT

      - name: Trigger signup email
        run: |
          # Call your app's signup endpoint with the test inbox address
          curl -X POST "http://localhost:3000/api/signup" \
            -H "Content-Type: application/json" \
            -d '{"email": "${{ steps.inbox.outputs.INBOX_ADDR }}"}'

      - name: Wait for email & verify
        run: |
          sleep 10
          MESSAGES=$(curl -s "https://api.mailchk.io/v1/test-inboxes/${{ steps.inbox.outputs.INBOX_ID }}/messages" \
            -H "X-API-Key: ${{ secrets.MAILCHK_API_KEY }}")

          COUNT=$(echo $MESSAGES | jq '.messages | length')
          if [ "$COUNT" -eq "0" ]; then
            echo "❌ No email received!"
            exit 1
          fi

          SUBJECT=$(echo $MESSAGES | jq -r '.messages[0].subject')
          echo "✅ Email received: $SUBJECT"

      - name: Cleanup
        if: always()
        run: |
          curl -s -X DELETE "https://api.mailchk.io/v1/test-inboxes/${{ steps.inbox.outputs.INBOX_ID }}" \
            -H "X-API-Key: ${{ secrets.MAILCHK_API_KEY }}"