Which plans include the API and webhooks?

The REST API and webhooks are part of the Growth and Enterprise plans. You can start on the free plan and upgrade when you are ready to connect your systems. The battery passport data endpoint works on every plan.

Are there rate limits?

Yes. Each API key can make 120 requests per minute. If you go over, the API answers with a 429 error and headers that say when you can try again. Lists are paged, up to 100 items per page. The API docs have the details.

How do you handle changes to the API?

The API is versioned (v1). We tell you about breaking changes at least 30 days in advance, as our Terms of Service set out, unless a change is urgently needed for security or legal reasons.

Is our customers' data protected?

You choose what each key can do, area by area. A product sync can have full access to products and none to contacts. Registrations and contacts are read-only, and every contact carries its marketing consent, so you only email people who agreed to it. Each key only sees your own company's data.

Is there a sandbox or test mode?

There is no separate sandbox. Create a separate key, for example called Staging, and keep test products as drafts, which is the default for new products. For webhooks, Send test delivers a sample event to your endpoint, and the delivery log shows how it answered.

Can we send data to HubSpot, Klaviyo or our helpdesk?

Yes, through webhooks and the API. Veribl doesn't have built-in apps for those tools, so you connect them with a webhook receiver, an automation tool or a small script.

The REST API reference is at support.veribl.com/rest-api, with webhooks at support.veribl.com/webhooks and API keys at support.veribl.com/api-keys. They cover every endpoint, error code and event, with examples.

Connect Veribl to the systems you already run.

A REST API for products, passports, help articles, spare parts, registrations and contacts, and webhooks that tell your other tools the moment something happens. For your ops, IT and e-commerce teams and their developers.

Read the API docs Start free

# Create a product
curl -X POST \
  https://app.veribl.com/api/v1/products \
  -H "Authorization: Bearer vdpp_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Aero 2 Helmet",
    "gtin": "04012345678901",
    "warrantyYears": 2
  }'

// 201 Created
{ "data": {
    "id": "3f1c…",
    "status": "draft"
} }

ERP sync keyProducts · Read and write

Webhook delivered · 200consumer.registered

What the API covers

Read and change your product content, passports and owner data from your own systems.

Products

Create, update and archive products with their GTIN, model, warranty, materials and certifications. Each new product gets its product page and QR code.

Passports

Fill passport data, read the checklist of what each EU rule still needs, publish a new version and read the version history. Battery data per serial number.

Help articles and translations

Create the articles on each product page, group them into categories, and save each one in every language you publish in.

Manuals and files

Upload PDFs and images, attach manuals to products, and read a manual's text back out.

Spare parts and accessories

Add spare parts, accessories and consumables with part numbers and repair details. Spare parts also show on the passport.

Registrations and contacts

Read every registered unit with its owner, and one row per owner with their marketing consent. Read-only, so customer data can't be changed from outside.

REST API

Plain JSON, one key per system.

Send a key with each request and get JSON back. Lists are paged, dates are ISO 8601, and errors come with a code your system can act on.

Access per area
Give each key no access, read, or read and write for products, passports, articles, registrations and contacts.
Rotate without downtime
A rotated key keeps working for 7 days, so you can swap it in your systems without breaking anything.
See every call
API activity in Settings shows each key's calls and errors for the last 14 days.

# Owners who agreed to marketing email
curl -G https://app.veribl.com/api/v1/contacts \
  -d consent=true \
  -H "Authorization: Bearer vdpp_…"

// 200 OK
{ "data": [{
    "email": "[email protected]",
    "country": "LV",
    "registrations": 2,
    "marketingConsent": true,
    "tags": ["vip"]
  }],
  "nextCursor": null
}

Webhooks

Know the moment something happens.

Add an HTTPS URL in Settings › Webhooks and Veribl sends it a JSON request for each event you pick: a registration, a claim, a product change.

Signed
Every delivery is signed with your endpoint's secret, so your server can check it came from Veribl.
Retries automatically
If your endpoint is down or returns an error, Veribl tries the delivery again.
Test and inspect
Send a test event, then read the delivery log: each event, its payload and how your endpoint answered.

POST https://crm.yourbrand.com/veribl
X-Webhook-Event: consumer.registered

{
  "event": "consumer.registered",
  "timestamp": "2026-10-14T16:20:00Z",
  "data": {
    "email": "[email protected]",
    "product": "Halden Aero 2",
    "warranty_expiry": "2028-10-14…",
    "email_consent": true
  }
}

Recent deliveries

consumer.registered16:20200
consumer.claim_submitted16:02200
product.updated15:47200

15 events you can subscribe to

Send all of them to one URL, or choose the events each endpoint receives.

Owners and registrations

consumer.registered
A customer registers a product
consumer.scanned
A customer scans a product QR code
consumer.feedback_submitted
A customer sends feedback
consumer.unsubscribed
A customer unsubscribes from emails
consumer.health_changed
An owner moves to Happy, Neutral or At risk

Support and claims

consumer.chat_completed
An AI support chat ends
consumer.chat_escalated
The AI hands a chat to your team
consumer.conversation_created
A new helpdesk conversation starts
consumer.conversation_replied
A customer replies in a conversation
consumer.claim_submitted
A customer submits a warranty claim
consumer.claim_updated
A warranty claim changes status

Products

product.created
A product is created
product.updated
A product is changed
product.status_changed
A product goes live, back to draft or is archived
product.deleted
A product is deleted

What teams connect

Common ways brands wire Veribl into the tools they already use.

New registration to your CRM

When an owner registers, a webhook sends them to your CRM or email tool, for example HubSpot or Klaviyo, with their product and consent.

Products from your PIM or ERP

Keep product names, GTINs, materials and certifications in one system and sync them to Veribl through the API.

Claims into your helpdesk

When a customer submits a warranty claim or the AI hands a chat to your team, a webhook opens a ticket where your team already works.

Passports from your PLM

When a product's data changes in your PLM, fill the passport fields and publish a new version, with a note for the history.

Alert the account team

When an owner moves to At risk, a webhook posts it to the team that can step in before a return or a bad review.

No code? Connect Claude

Give Claude your PDF manuals and it writes the product pages through the same access, without a developer.

See Connect Claude

For IT teams

Only the access each system needs.

Keys belong to your company, not to the person who made them, and every change a key makes is in the audit log.

Customer data stays scoped
Registrations and contacts are read-only. Each contact carries its marketing consent, and a key only sees your company's data.
Revoke in one click
A leaked key stops working the moment you revoke it.
Single sign-on
Your team signs in to Veribl with your identity provider through SAML single sign-on, on Growth and Enterprise.

Get started

From a new key to your first call or event.

Step 1
Create a key
In Settings › API keys, name the key after the system that uses it and choose its access per area.
Step 2
Make a call or add a webhook
Call https://app.veribl.com/api/v1 with the key, or add your URL in Settings › Webhooks and pick events.
Step 3
Test and watch
Send a test event and follow your calls and deliveries in the activity and delivery logs.

Frequently asked questions

Docs

Turn every product into your best channel.

Start free in minutes, or book a personalized walkthrough with our team.

Free for your first products. Live in minutes, no credit card.

Get started

A personalized walkthrough of Veribl with our team.

Book a Demo

Connect Veribl to the systems you already run.

Products

Passports

Help articles and translations

Manuals and files

Spare parts and accessories

Registrations and contacts

Access per area

Rotate without downtime

See every call

Signed

Retries automatically

Test and inspect

Owners and registrations

Support and claims

Products

New registration to your CRM

Products from your PIM or ERP

Claims into your helpdesk

Passports from your PLM

Alert the account team

No code? Connect Claude

Customer data stays scoped

Revoke in one click

Single sign-on

Create a key

Make a call or add a webhook

Test and watch

Frequently asked questions

REST API reference

Webhooks

API keys

Single sign-on

Turn every product into your best channel.