Capvant

Push a deal status change

post
https://sandbox.capvant.com/v1/inbound/status/{token}
POST
/inbound/status/{token}

The Capvant deal reference (e.g. CV-4F2A9K). Your CRM may also send the Capvant lead id you received as partnerLeadId, or the id you returned to us when the lead was created.

Decline reason, free text. Required when status is declined (400 otherwise).

Funded amount.

ISO 4217 code: GBP, USD or EUR.

data

Optional facts you verified on your side. Stored with the deal so Capvant does not re-collect them.

Product you are offering or funded, e.g. MCA, term_loan, line_of_credit.

Your own stage name, unmapped, for our records.

Commission due to Capvant on this funding.

Send this whenever a deal you received from Capvant changes state. The deal must have been routed to you. Statuses: in_review, offer_made, declined (add a reason), funded (add amount and currency). If your CRM emits different field names or status values, Capvant maps them for you; ask your Capvant contact or set the mapping in the Hub.

Path Parameters

token*string

Your personal inbound secret, part of the URL shown in the Lender Hub.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

Shell
curl -X POST "https://sandbox.capvant.com/inbound/status/string" \  -H "Content-Type: application/json" \  -d '{    "dealRef": "CV-4F2A9K",    "status": "funded",    "amount": 85000,    "currency": "USD",    "data": {      "product": "MCA",      "annualRevenue": 620000,      "creditScore": 660,      "term": "9 months",      "factorRate": 1.28,      "commissionAmount": 3400,      "commissionCurrency": "USD"    }  }'
JSON
{  "ok": true,  "dealRef": "CV-4F2A9K",  "status": "funded"}

Inbound status

Push deal status changes to Capvant from your own system. One URL per lender, one JSON shape for everyone. No API key: the secret in the URL identifies you. Copy the URL from your Lender Hub, Integration page.

Partner API

The Partner API is for introducers: accountants, brokers, platforms and embedded partners who send a business to Capvant and want to follow what happens next without leaving their own product.