conecto. Get started
Invoices

Remind about an unpaid invoice

invoices_remind · Changes data · Markdown

Emails the customer a reminder about a sent invoice with a balance, at most once a day.

$0.02 a call

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

An example

Remind Café Lotte about their unpaid invoice, kindly.

Your agent callsinvoices_remind$0.02 a call

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
{
  "invoice_id": "2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f",
  "message": "Just a friendly reminder about the bench cushions. Thank you!"
}
What comes back
{
  "invoice": {
    "invoice_id": "2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f",
    "kind": "invoice",
    "number": "INV-0042",
    "status": "sent",
    "currency": "EUR",
    "issue_date": "2026-10-14",
    "due_date": "2026-10-28",
    "overdue": false,
    "days_overdue": 0,
    "customer": {
      "contact_id": null,
      "company_id": null,
      "name": "Hotel Elbblick GmbH",
      "email": "lukas.meyer@hotel-elbblick.example",
      "address": "Elbchaussee 120\n22763 Hamburg",
      "tax_id": "",
      "country": null
    },
    "total": "13887.30",
    "total_formatted": "€13,887.30",
    "amount_paid": "0.00",
    "balance": "13887.30",
    "balance_formatted": "€13,887.30",
    "public_url": "https://cncto.co/i/y6FF9DtJmrblhSH8Y2bB6KyjqbOwRcyc",
    "created_at": "2026-10-14T08:00:00+00:00",
    "sent_at": "2026-10-14T08:00:00+00:00",
    "credited": "0.00",
    "items": [
      {
        "description": "Bistro chair, beech\nStackable, for terraces",
        "quantity": "40",
        "unit_price": "320",
        "tax_rate": "19",
        "discount_percent": "10",
        "amount": "12800.00",
        "discount": "1280.00",
        "tax": "2188.80",
        "total": "13708.80"
      },
      {
        "description": "Delivery and setup",
        "quantity": "1",
        "unit_price": "150",
        "tax_rate": "19",
        "discount_percent": "0",
        "amount": "150.00",
        "discount": "0.00",
        "tax": "28.50",
        "total": "178.50"
      }
    ],
    "totals": {
      "subtotal": "12950.00",
      "subtotal_formatted": "€12,950.00",
      "discount": "1280.00",
      "discount_formatted": "€1,280.00",
      "tax": "2217.30",
      "tax_formatted": "€2,217.30",
      "total": "13887.30",
      "total_formatted": "€13,887.30",
      "credited": "0.00",
      "credited_formatted": "€0.00",
      "amount_paid": "0.00",
      "amount_paid_formatted": "€0.00",
      "balance": "13887.30",
      "balance_formatted": "€13,887.30",
      "taxes": [
        {
          "rate": "19",
          "base": "11670.00",
          "amount": "2217.30",
          "amount_formatted": "€2,217.30"
        }
      ]
    },
    "supply": {
      "label": "Date of supply",
      "text": "October 14, 2026",
      "from": "2026-10-14",
      "until": "2026-10-14"
    },
    "tax_exemption": null,
    "tax_note": null,
    "vat_exchange_rate": null,
    "national_vat": null,
    "e_invoice": null,
    "notes": "",
    "payment_link": null,
    "business": {
      "name": "Hansen & Voss GmbH",
      "address": "Billbrookdeich 112\n22113 Hamburg\nGermany",
      "tax_id": "DE123456789",
      "email": "billing@hansenvoss.example",
      "phone": "+49 40 66969 100",
      "logo_file_id": "",
      "footer": "Please pay by bank transfer to Hansen & Voss GmbH\nIBAN DE89 3704 0044 0532 0130 00, BIC COBADEFFXXX",
      "tax_label": "VAT",
      "paper": "a4",
      "country": "DE",
      "legal_notes": "Hansen & Voss GmbH, Amtsgericht Hamburg HRB 123456\nManaging directors: Clara Hansen, Henrik Voss",
      "document_language": ""
    },
    "pdf": {
      "file_id": "8af692ea-10f2-4a3d-b579-f40d62f45613",
      "name": "Invoice INV-0042.pdf",
      "content_type": "application/pdf",
      "size": "582 bytes",
      "size_bytes": 582,
      "sha256": "7a628ee1199dd863f0236a61a39b6729a977b4ea18a669e9930a57280cb2326e",
      "created_at": "2026-10-14T08:00:00+00:00",
      "download_url": "https://cncto.co/d/8af692ea-10f2-4a3d-b579-f40d62f45613?t=eyJmIjoiOGFmNjkyZWEtMTBmMi00YTNkLWI1NzktZjQwZDYyZjQ1NjEzIiwiZXhwIjoxNzkyMTYwODk3fQ:1xHMRN:saa1FT_T2xLqTtAOq2iLNny9QXAARThDbjgMdE-DbMg",
      "link_expires_in_hours": 24
    },
    "payments": [],
    "quote_id": null,
    "credit_notes": [],
    "viewed_at": null,
    "accepted_at": null,
    "declined_at": null,
    "paid_at": null,
    "voided_at": null,
    "void_reason": null,
    "last_emailed_at": "2026-10-14T08:00:00+00:00",
    "reminders_sent": 1,
    "history": [
      {
        "at": "2026-10-14T08:00:00+00:00",
        "event": "created",
        "detail": "",
        "by": "key 4101 (Pip)"
      },
      {
        "at": "2026-10-14T08:00:00+00:00",
        "event": "sent",
        "detail": "INV-0042",
        "by": "key 4101 (Pip)"
      }
    ]
  },
  "emailed_to": "lukas.meyer@hotel-elbblick.example"
}

Use it when

An invoice is overdue or due soon and the customer should be nudged.

What it does

Email the customer a reminder about a sent invoice that still has a balance: the amount due, the due date and the links to pay. At most once a day per invoice.

What comes back

invoice: the document with its balance and due date; emailed_to: who the reminder went to. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
invoice_idRequiredstringThe invoice_id invoices_create returned (quotes and credit notes have one too). Exactly 36 characters.
messagestringA short note in the email, e.g. "Just a friendly reminder.". Up to 2,000 characters.
tostringSend to this address instead of the customer's email. Up to 254 characters.
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 on https://api.conecto.chat/mcp/invoices. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/invoices_remind \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f","message":"Just a friendly reminder about the bench cushions. Thank you!"}'

When it refuses

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

CodeWhenWhat to do
not_found404No quote or invoice of the business has that invoice_id.Find it with invoices_list and use its invoice_id.
not_an_invoice400The id is a quote.Send a quote again with invoices_send instead.
not_sent409The invoice is still a draft.Send it with invoices_send.
nothing_due409Nothing is owed on the invoice.No reminder is needed.
too_soon429The customer was emailed about it in the last 24 hours.Remind again after the time the message gives.
no_email409The document has no customer email to send to.Pass to, or set customer.email on the draft with invoices_update.
payment_required_for_outbound402The balance is still free credit, which cannot email people outside the business.Top up once (POST /v1/topups), or send with email: false and hand the link over yourself.
suppressed422The address bounced, complained or unsubscribed before.Send to another address with to.
too_many_emails429This document was emailed as often as it may in 24 hours.Try again tomorrow.
daily_email_limit429The business emailed as many quotes and invoices in 24 hours as it may.Try again tomorrow, or ask Conecto for more.
email_failed502The email could not be sent; nothing was charged.Call again in a moment.
unavailable503The PDF could not be made right now; nothing was charged.Call again in a moment.

More Invoices tools

All 24 tools

Give this to your agent.

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