Hub Insure
Documentation

Build the insurance experience your customers expect.

REST APIs, signed webhooks, embeddable widgets, and SDKs for insurers, brokers, MGAs, and embedded partners. Start in the sandbox, move to production when you're ready.

Guides

Everything you need to ship

Quickstart

  • Create an account
    Sign up at hub-insure.com, choose insurer / broker / developer, and verify your email.
  • Generate an API key
    In App → Developer → Keys, click Create key. Keys are shown once — copy and store securely.
  • Make your first quote call
    POST /api/v1/quotes/motor with your test key and a sample payload to receive a priced quote in <300ms.

Authentication

  • Bearer tokens
    All API requests require `Authorization: Bearer hi_live_…` or `hi_test_…`. Test keys never touch production carriers.
  • Scopes
    Keys can be scoped to quote, bind, pay, policy, claims, or admin. Least-privilege is enforced server-side.
  • Rotation
    Rotate keys from the dashboard at any time. The previous key keeps working for 24h to avoid downtime.

Core resources

  • Products
    Motor, medical, travel, property, life. Each product exposes its schema, rating fields, and bindable coverages.
  • Quotes
    Create, retrieve, list, and bind quotes. Idempotency-Key header supported on POST.
  • Policies
    Issue, retrieve, endorse, cancel (pro-rata), and renew. Documents are returned as signed URLs.
  • Claims
    FNOL intake, status transitions, document upload, adjuster notes, and settlement.

Webhooks

  • Events
    quote.created, quote.bound, payment.succeeded, policy.issued, policy.endorsed, policy.cancelled, claim.updated.
  • Signatures
    Every payload is signed with HMAC-SHA256 in the `X-Hub-Signature` header. Verify before processing.
  • Retries
    Failed deliveries retry with exponential backoff up to 24h. Replay manually from the dashboard.

Security & compliance

  • Data residency
    Production traffic stays inside the regional cluster you select (GCC or Levant).
  • Encryption
    TLS 1.3 in transit, AES-256 at rest. Customer PII is tokenized in API logs.
  • Audit trail
    Every state change is recorded with actor, before/after, and request id.
API Reference

Endpoint index

MethodPathDescription
POST
/api/v1/quotes/motorCreate a motor quote
GET
/api/v1/quotes/{id}Retrieve a quote
POST
/api/v1/quotes/{id}/bindBind a quote
POST
/api/v1/paymentsCreate a payment intent
POST
/api/v1/policies/{id}/issueIssue a policy after payment
POST
/api/v1/policies/{id}/endorseMid-term endorsement
POST
/api/v1/policies/{id}/cancelCancel with pro-rata refund
POST
/api/v1/policies/{id}/renewGenerate renewal offer
POST
/api/v1/claimsSubmit FNOL
POST
/api/public/quoteEmbedded widget quote (public)

Full payload schemas and live examples are available in the API reference.

Talk to an integration engineer

We help insurers and brokers go live in weeks, not quarters. Bring your product schema — we'll map it.