Root Insurance integration

SA insurtech: quotes, policies, claims, policyholders, products

Help CentreConnectors

Overview

Root is a South African insurtech – embedded insurance platform with modular policies (cellphone, gadgets, life, funeral). The Automize Root connector covers quotes, policies, claims, policyholders, products.

  • Regions: South Africa.
  • Plans: Partner integration – apply via Root.

Setting up the connection

Auth type: API Key.

  1. Root admin → API Keys → create token.
  2. In Automize → Settings → Connectors → Root Insurance. Paste token.

Find your credentials at https://app.root.co.za/.


Rate limits

Per-account, generous for partner integrations.


Data model

Embedded insurance primitives:

    Product (modular policy template) ─── Application (quote) ─── Policy ─── Claims
    Policyholder (the insured)

Available operations

13 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Cancel PolicyGeneralCancel an active policy
Create ApplicationGeneralCreate a policy application
Create ClaimGeneralSubmit a new claim
Create PolicyholderGeneralCreate a new policyholder
Create QuoteGeneralGenerate an insurance quote
Get PolicyGeneralGet policy details by ID
Get PolicyholderGeneralGet policyholder details
Get ProductGeneralGet product details by ID
Get QuoteGeneralGet quote details by ID
List ClaimsGeneralList all claims
List PoliciesGeneralList all policies
List ProductsGeneralList available insurance products
List QuotesGeneralList all quotes

Operations

Cancel Policy

Cancel an active policy

ParameterRequiredTypeDescription
Reason reasonYestext
Policy Id policy_idYestext

Create Application

Create a policy application

ParameterRequiredTypeDescription
Quote Id quote_idYestext
Policyholder Id policyholder_idYestext

Tips

  • product_module_key + applicant + module-specific fields.

Create Claim

Submit a new claim

ParameterRequiredTypeDescription
Policy Id policy_idYestext
Description descriptionYestext

Tips

  • policy_id + claimant + incident details + supporting docs.

Create Policyholder

Create a new policyholder

ParameterRequiredTypeDescription
Id Number id_numberYestext
First Name first_nameYestext
Last Name last_nameYestext
Email emailYestext
Date Of Birth date_of_birthYestext

Create Quote

Generate an insurance quote

ParameterRequiredTypeDescription
Type typeYestext
Product Module Id product_module_idYestext
Data dataYestextarea

Get Policy

Get policy details by ID

ParameterRequiredTypeDescription
Policy Id policy_idYestext

Get Policyholder

Get policyholder details

ParameterRequiredTypeDescription
Policyholder Id policyholder_idYestext

Get Product

Get product details by ID

ParameterRequiredTypeDescription
Product Id product_idYestext

Get Quote

Get quote details by ID

ParameterRequiredTypeDescription
Quote Id quote_idYestext

List Claims

List all claims

No input parameters.

Tips

  • Filter by policy_id, status.

List Policies

List all policies

No input parameters.


List Products

List available insurance products

No input parameters.

Tips

  • Returns available products (gadget insurance, life, etc.) for your partner agreement.

List Quotes

List all quotes

No input parameters.


FAQ

Root vs MiWay?
Root: tech-first, API-native, embedded-insurance partnerships. MiWay: traditional direct insurer with broker API.
Sandbox?
Yes – Root sandbox uses test policies + payments. Set environment=sandbox on connection.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.