{"uid":"cap_wY7-xLRuu3ZlkOsWCVKde","slug":"paidpilot-reminder-draft-3726c33c","name":"PaidPilot Reminder Draft","description":"PaidPilot Invoice API: Draft a payment reminder email (friendly, firm or final notice). Returns subject + plain-text body for an unpaid invoice, days overdue, the recommended tone and the next step. Template-based, deterministic. Draft only: this API never sends email.","url":"https://api.paidpilot.io/v1/reminder-draft?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tone":{"enum":["friendly","polite","firm","final"],"type":"string","description":"\"friendly\" (alias \"polite\"), \"firm\", or \"final\""},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Today's date for the days-overdue count, YYYY-MM-DD (default: today, UTC)"},"amount":{"type":"number","maximum":1000000000,"description":"Amount due","exclusiveMinimum":0},"currency":{"type":"string","default":"USD","description":"ISO-4217, default USD"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD"},"from_name":{"type":"string","maxLength":120,"minLength":1,"description":"Your name or business, used in the sign-off"},"client_name":{"type":"string","maxLength":120,"minLength":1,"description":"Client's name for the greeting"},"payment_link":{"type":"string","format":"uri","maxLength":500},"invoice_number":{"type":"string","maxLength":64,"minLength":1},"late_fee_terms":{"type":"string","maxLength":200,"minLength":1,"description":"Your agreed late-fee terms, e.g. \"1.5% per month\"; mentioned in the final notice only"},"final_deadline_days":{"type":"integer","default":7,"maximum":60,"minimum":1,"description":"Final notice: days the client has to pay"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y3IX2ux-cq0e2UNinZSR3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a payment reminder email (subject + plain-text body) for an unpaid invoice, given tone, overdue days, and invoice details — draft only, never sends.","exampleAgentPrompt":"Draft a firm payment reminder email for my client Acme Corp — invoice #INV-2081 for $3,450 USD was due on 2025-05-01. Sign it from Riverside Consulting, include this payment link https://pay.example.com/inv2081, and flag that late fees are 1.5% per month.","exampleUseCases":[{"title":"Freelancer chasing overdue payment","prompt":"Write a friendly payment reminder to my client Jordan Lee for invoice #FL-0089, $1,200 USD due on 2025-04-15. Sign it from me, Priya Sharma, and include a payment link at https://pay.me/fl0089 — I just want a gentle nudge, not anything aggressive."},{"title":"Final notice before collections","prompt":"Generate a final notice email for invoice #ENT-5521 — my client Goldstone Media owes $8,750 USD, it was due 2025-03-20. Sign it from Atlas Agency, use a final tone, include https://pay.atlas.io/5521 as the payment link, mention the late fee terms are 2% per month, and give them 7 days to pay."},{"title":"Automated AR reminder in billing workflow","prompt":"As of today 2025-05-28, draft a firm reminder for invoice #B2B-3300 sent to Vertex Partners for $22,000 USD due 2025-05-07. Sign from Beacon Solutions and include the payment link https://payments.beacon.io/b2b3300."}],"resultDescription":"Returns a JSON object containing: a ready-to-use email subject line, a plain-text email body personalized with client name, invoice number, amount, and due date, the number of days the invoice is overdue, the tone applied (friendly/polite/firm/final), and a recommended next step for the sender. The draft is never transmitted — the caller is responsible for sending.","failureModes":["Missing required fields (invoice_number, client_name, from_name, due_date, amount) returns a 422 validation error","Invalid date format for due_date or as_of returns a 400 error","amount <= 0 or exceeding maximum returns a 400 validation error","Invalid tone enum value (not friendly/polite/firm/final) returns a 422 error","payment_link not a valid URI returns a 400 error","final_deadline_days outside 1–60 range returns a 422 error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, template-based payment reminder email draft and do not need AI-generated creative copy or actual email delivery. Ideal for accounts-receivable automation pipelines, billing systems, or agents that compose and then send the email via a separate channel. Prefer over general-purpose LLM text generation when consistency, structured output (subject + body + metadata), and low per-call cost matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:36:03.046Z","isFirstParty":false,"canonicalSlug":"paidpilot-reminder-draft-3726c33c"}