Skip to main content

Create a warranty session

POST 
/api/warranty/session

Creates a warranty session for a given vehicle. Returns a one-time URL to display to the customer.

Only vehicle is required — all other fields are optional. languageCode defaults to en-GB if omitted.

Request​

Responses​

Session created — display the returned URL to the customer.

Callbacks​

POST 
{$your-configured-webhook-endpoint}

[OUTGOING EVENT] Sent after a warranty contract is successfully subscribed.

Fires at the end of the subscription tunnel once the contract has been persisted. It is fire-and-forget: a webhook failure does not roll back the subscription.

The webhook URL is configured on the Software record linked to the customer subscription (provisioned via gRPC by the IDP service). If no URL is configured, no request is sent.

Authentication: No signature header is added. Secure the receiver endpoint at the network level or validate warrantySubscriptionId against your own records.

Callbacks Responses​

Webhook received.