Create an insurance contract

OAuth scope: insurance_contract.write

Creates a single insurance contract for the authenticated organization. This endpoint supports various types of insurance contracts, and includes critical information, such as the policy provider, pricing, and current status.

POST /v2/insurance_contracts

Create an insurance contract

cURL

curl --request POST \
  --url https://thirdparty.qonto.com/v2/insurance_contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "insurance_contract": {
    "name": "ProLiability Plan 2024",
    "contract_id": "12345",
    "origin": "insurance_hub",
    "provider_slug": "axa",
    "type": "business_liability",
    "status": "active",
    "troubleshooting_url": "https://patner.com/troubleshoot",
    "service_url": "https://partner.com/service",
    "expiration_date": "2025-12-31",
    "start_date": "2024-12-31",
    "renewal_date": "2025-12-31",
    "payment_frequency": "month",
    "price": {
      "value": "99.99",
      "currency": "EUR"
    }
  }
}
'

201

Example

{
  "insurance_contract": {
    "id": "888e4567-e89b-12d3-a456-426614174123",
    "name": "ProLiability Plan 2024",
    "contract_id": "12345",
    "origin": "insurance_hub",
    "provider_slug": "axa",
    "type": "business_liability",
    "status": "active",
    "troubleshooting_url": "https://patner.com/troubleshoot",
    "service_url": "https://partner.com/service",
    "expiration_date": "2025-12-31",
    "start_date": "2024-12-31",
    "renewal_date": "2025-12-31",
    "payment_frequency": "month",
    "price": {
      "value": "99.99",
      "currency": "EUR"
    }
  }
}

Authorizations

Authorization · string · header · required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token · string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json

insurance_contract · object · required

Insurance contract data provided by Partner

Show child attributes

Response

201

application/json

Returns the insurance contract created.

insurance_contract · object · required

Insurance contract data provided by Partner

Show child attributes