Invoices

Remind everyone who is overdue

invoices_remind_overdue · Changes data · Markdown

Emails a reminder about every invoice at least some days overdue, the longest overdue first.

$0.02 per reminder sent

From your agent’s balance. A call that fails costs nothing.

An example

Remind everyone whose invoice is more than a week late, and tell me who you could not reach.

Your agent callsinvoices_remind_overdue$0.02 per reminder sent

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "days_overdue": 7,
  "message": "Just a friendly reminder. If you have paid in the meantime, thank you, and please ignore this email."
}
What comes back
{
  "reminded": [
    {
      "invoice_id": "1a63b285-3469-42af-a0fe-c0d535b39ca9",
      "number": "INV-0042",
      "customer": "Café Lotte",
      "due_date": "2026-09-03",
      "emailed_to": "kasse@cafe-lotte.example"
    },
    {
      "invoice_id": "36c9b31d-147d-415c-b666-affeb43ce915",
      "number": "INV-0043",
      "customer": "Hotel Elbblick GmbH",
      "due_date": "2026-09-24",
      "emailed_to": "lukas.meyer@hotel-elbblick.example"
    }
  ],
  "skipped": [],
  "days_overdue": 7
}

Use it when

Chasing everyone who is late in one go, by hand or from a weekly schedule.

What it does

Email a reminder about every sent invoice at least days_overdue days past its due date that still has a balance, the longest overdue first, up to limit invoices: one call, or one weekly schedule (schedules_create), chases them all. Each invoice is reminded at most once a day; the ones that can't be (no customer email, emailed in the last 24 hours, the address bounced) are listed with why. $0.02 per reminder sent.

What comes back

reminded: the invoices reminded, each with its number, customer, due date and who was emailed; skipped: the ones that could not be, with why; days_overdue. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
days_overdueinteger1 to 365. Default: 1.
messagestringA short note in each email, e.g. "Just a friendly reminder.". Up to 2,000 characters.
limitinteger1 to 50. Default: 20.
link_hoursintegerHow long the PDF download link works, in hours (up to 168). 1 to 168. Default: 24.

The call

Over MCP, call invoices_remind_overdue on https://api.conecto.chat/mcp/invoices. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/invoices_remind_overdue \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days_overdue":7,"message":"Just a friendly reminder. If you have paid in the meantime, thank you, and please ignore this email."}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
payment_required_for_outbound402The balance is still free credit, which cannot email people outside the business.Top up once (POST /v1/topups).
unavailable503The PDF could not be made right now; nothing was charged.Call again in a moment.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md