# Connect Refund Tracker

URL: https://refunds.studioapps.dev
OpenAPI: https://refunds.studioapps.dev/openapi.json
Base URL: https://refunds.studioapps.dev/api/v1

Auth: Bearer token (not OAuth)
Demo token: refunds_demo_all
Universal demo: studio_demo_all

## Example prompts

- "Which refunds are still pending?"
- "Return windows closing this week"
- "Is Swiggy One worth it for my orders?"

## Gmail integration (Muse reads email → Refund Tracker parses)

Refund Tracker does NOT access Gmail. Use Muse's Gmail connector to read order emails, then:

1. POST /api/v1/gmail/sync with header X-Studio-User-Id: <user_id>
2. Body: { "emails": [{ "message_id", "from", "subject", "body", "date" }] }
3. Test: { "use_demo_samples": true }

Full guide: https://refunds.studioapps.dev/api/v1/integration/guide


## User identity (persistent data)

Send X-Studio-User-Id: <stable-id> on sync/watch endpoints so data persists per user.

## Trust

Responses include meta.data_version, meta.sources, and disclaimers where official verification is required.

Submit to Muse directory: https://muse.ai/platform
Hub: https://apps.studioapps.dev