Capvant

Accept an offer

post
https://sandbox.capvant.com/partner/v1/leads/{id}/offers/{offerId}/acceptance
POST
/leads/{id}/offers/{offerId}/acceptance

The business has chosen this option. No body: accepting is a choice, not a payload. A live acceptance runs through the same path the business would use from its own account, so the handover happens exactly once.

Authorization

AuthorizationBearer <token>

An access token from POST /oauth/token. Valid for one hour. Preferred, because a leaked request log then exposes an hour rather than a permanent credential.

In: header

Path Parameters

id*string

The lead id returned by POST /leads.

Formatuuid
offerId*string

The offer id from GET /leads/{id}/offers.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

Shell
curl -X POST "https://sandbox.capvant.com/leads/497f6eca-6276-4993-bfeb-53cbbbba6f08/offers/string/acceptance"
JSON
{  "lead_id": "string",  "offer_id": "string",  "state": "accepted",  "simulated": true}