Build with the
B2B debt collection API.
Submit overdue invoices from your product. Receive signed webhook events for calls, emails, disputes, payments and payouts.
- Your platformAn overdue invoice
A customer authorizes a placement.
- Modern CollectionsThe collection file
Verification, outreach, disputes, and payments.
- Back in your productA status you can act on
Signed events and the current API record.
From agreement to first placement.
Plan the creditor setup alongside the technical work. Your team chooses which invoices customers can submit, gets their authorization, and keeps API credentials on your server, scoped to the right creditor. We verify each creditor, check compliance before outreach and do the collecting. API access and a successful request do not replace verification or clearance to contact a debtor. To start without building, place invoices from the dashboard, by CSV upload or through QuickBooks Online: see Integrations.
Agree on the handoff
Confirm your partnership, creditor permissions, API access, and the experience your team will own. Identify who supplies documents and handles creditor questions.
Your team + Modern CollectionsOnboard the creditor
Create or link the creditor, collect the required business and ownership information, and complete verification, the agreement, and payout setup. An invitation can bring the creditor into our hosted flow.
Each creditor is onboarded separatelySend your first placement
Save the returned placement ID, handle review or validation responses, and confirm the right creditor owns the file. Each placement starts real collection.
API request or dashboard importTest your webhook receiver
Verify event signatures, handle duplicate delivery, and compare your displayed status with the current API record. Confirm operating coverage before sending more placements.
Your receiver + our collection team
What can be handled through the partner API?
Partner endpoints can create linked creditors, report missing business-verification fields, submit verification, and invite a creditor to the hosted workflow. Agreement authority and payout setup depend on the approved onboarding arrangement. Confirm that arrangement with us before promising a fully embedded signup.
For placement requests with a partner key, X-MC-Creditor names the linked creditor by UUID or external reference. The partner must have the required authority. Each creditor remains separately scoped.
One invoice, in both directions.
Send the invoice and debtor details from your product.
{
"invoice_number": "INV-4210",
"invoice_amount": "4210.00",
"debtor": {
"company_name": "Example Supply Co.",
"primary_email": "ap@example.com"
}
}Request body excerpt. Authentication and creditor scope are covered in the API reference.
See complete requests and webhook handling
What does the placement request require?
The required fields are a positive invoice_amount and debtor.company_name. Send the invoice number, dates, contact details, and debtor state when available so the file is useful and the duplicate and compliance checks have context. The amount accepts up to two decimal places.
callback_url sets a public HTTPS destination for this placement’s events. It is optional when a creditor or partner default is configured. Obtain the relevant outbound signing secret during setup before accepting deliveries.
Can we use the CLI or an agent instead?
In ChatGPT, find Modern Collections in the ChatGPT plugin directory, connect it and sign in with your Modern Collections dashboard login. In Claude.ai, add https://api.moderncollections.io/mcp as a custom connector and sign in the same way. No API key is needed, and you can disconnect either under Settings → Developer & integrations → Connected apps. A ChatGPT Business or Enterprise workspace can also add the URL as a custom MCP server.
A connected assistant can read an AR aging export and say which accounts to place before it places any.
Any other agent connects to the same URL with header Authorization: Bearer and the creditor API key from Settings → Developer & integrations → API key. The same card is at GET /v1/public/mcp and llms.txt. A partner key also sends X-MC-Creditor.
To file an invoice the user handed over: placement_create (this places a real invoice, and we review each new placement before outreach starts, so confirm the company and amount first), then document_upload with the file, then document_process. placement_recall stops a placement that should not have been opened. The local package name is modern-collections. An agent still needs the creditor’s key or a signed-in connection; it does not bypass onboarding or compliance.