Discover Billers from Email

Connect a user's Gmail account to automatically discover which billers they interact with, based on billing emails in their inbox.

How it works

1Your app redirects the user to Google's OAuth consent screen using the URL from POST /emails/gmail/oauth-url.
2After the user grants access, call POST /emails/gmail/connect to connect their Gmail.
3BillerAPI scans their emails and matches senders to known billers.
4Retrieve discovered billers via GET /emails/messages.

Step 1: Get OAuth URL

curl -X POST https://sandbox.api.billerapi.com/emails/gmail/oauth-url \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_123",
    "client_id": "your_client_id",
    "redirect_uri": "https://yourapp.com/callback"
  }'

Note

The OAuth URL endpoint does not require authentication. This is by design, as it initiates the user-facing OAuth flow.

Step 2: Connect Gmail

After the user completes OAuth and is redirected back to your app, connect their Gmail:

cURL

curl -X POST https://sandbox.api.billerapi.com/emails/gmail/connect \
  -H "Content-Type: application/json" \
  -H "X-Client-ID: your_client_id" \
  -H "X-Client-Secret: your_client_secret" \
  -d '{"user_id": "user_123", "client_id": "your_client_id"}'

Step 3: Retrieve Discovered Billers