How to Integrate Smiirl Counter with Hubhus

Modified on Tue, 27 Jan at 3:39 PM

How to Integrate Smiirl Counter with Hubhus

Connect your Smiirl physical counter to Hubhus and display real-time sales numbers, lead counts, or bookings on a beautiful mechanical display.

On this page

How to Integrate Smiirl Counter with Hubhus

What you'll need

A Smiirl counter (order from smiirl.com)
Smiirl account with counter set up
Hubhus account with HTTP & Webhooks access
An HTML component in Hubhus to store your counter logic

Step 1: Configure Your Smiirl Counter

First, you need to get your Smiirl API credentials:

Create and set up your Smiirl counter following the manufacturer's instructions

Go to https://my.smiirl.com/en/ and log in to your Smiirl account

Click on Settings

Under Options, select PUSH NUMBER

This will reveal your Counter ID (identifier) and Token

Save these credentials—you'll need them for the Hubhus integration

Keep your Token secure

Your Smiirl token is like a password. Don't share it publicly or commit it to version control systems.

Step 2: Create Your Counter Logic in Hubhus

Build your counter calculation and save it as an HTML component:

Go to Settings → HTML Components in Hubhus

Create a new HTML component

Name it something descriptive like "Smiirl Counter - Sales This Month"

In the component, define your counter logic (e.g., count campaigns with specific status, sum field values, count bookings, etc.)

The component should output a single number value

Save the HTML component and note its slug for later

Pro Tip

Use Hubhus placeholders and filters to calculate your counter dynamically. For example, use search results, campaign counts, or aggregated field values.

Step 3: Set Up HTTP Webhook in Hubhus

Create a webhook that sends your counter value to Smiirl:

Go to Settings → HTTP & Webhooks

Click New to create a new webhook

Set Method: GET

Build the URL using the pattern below

URL Pattern

http://api.smiirl.com/{COUNTER_ID}/{ACTION}/{TOKEN}/{VALUE}

Replace these placeholders:

{COUNTER_ID} – Your Smiirl Counter ID from Step 1
{ACTION} – Use set to set an absolute number, or increment to add to the current count
{TOKEN} – Your Smiirl Token from Step 1
{VALUE} – Insert your HTML component using /COMPONENT_SLUG syntax

Example URL

http://api.smiirl.com/12345/set/abc123xyz/sales-counter-component

Where sales-counter-component is the slug of your HTML component that outputs the number.

Step 4: Trigger the Webhook

Choose when to update your Smiirl counter by adding the webhook to an automation or action listener:

Option A: Action Listener (Event-Based)

Go to Settings → Action Listeners

Create a new action listener

Set the trigger event (e.g., "Campaign created", "Status changed", "Booking confirmed")

Add your HTTP webhook as an action

Save the action listener

Use case: Update counter immediately when specific events occur (best for increment actions).

Option B: Automation (Time-Based or Rule-Based)

Go to Settings → Automation

Create a new automation rule

Set conditions (e.g., "Every hour", "Every morning at 8 AM", or when field values change)

Add your HTTP webhook as an action

Save the automation rule

Use case: Update counter on a schedule or when aggregate values change (best for set actions with calculated totals).

Pro Tip

For total counts (like "Sales this month"), use set action with scheduled automation. For individual events (like "New lead"), use increment with action listeners.

Common Use Cases

Display Total Sales This Month

HTML Component: Count campaigns with status "Won" created this month
Action: set
Trigger: Automation running every hour

Count New Leads Today

HTML Component: Count campaigns created today
Action: set
Trigger: Automation running every 30 minutes

Increment on Every New Booking

HTML Component: Output 1
Action: increment
Trigger: Action listener on "Booking confirmed" event

Reset counters manually

If using increment, remember to reset your Smiirl counter manually at the start of each period (day/week/month) via the Smiirl dashboard.

Smiirl API Actions

The Smiirl API supports the following actions:

Action	Description	Use Case
`set`	Set counter to an absolute number	Total sales, total leads, aggregate counts
`increment`	Add 1 to current counter value	Individual events (new lead, new sale)
`decrement`	Subtract 1 from current counter value	Inventory tracking, pending tasks

Testing Your Integration

Test your HTML component output directly in Hubhus to ensure it returns the correct number

Trigger your automation or action listener manually

Check your Smiirl counter—it should update within a few seconds

Monitor your HTTP webhook logs in Hubhus to verify requests are being sent successfully

Success!

Your Smiirl counter is now displaying live data from Hubhus. Your team can watch your numbers grow in real-time!

Troubleshooting

Counter not updating?

Verify your Counter ID and Token are correct
Check HTTP webhook logs in Hubhus for error responses
Ensure your HTML component outputs a valid number (not text or HTML)
Confirm your automation/action listener is triggering correctly

Counter shows wrong number?

Review your HTML component logic and test it independently
Check if you're using set vs increment correctly
If using increment, manually reset the counter in Smiirl dashboard

API rate limits?

Smiirl may have rate limits on API requests
Avoid triggering webhooks too frequently (use scheduled automation instead of action listeners for high-volume events)
Consider batching updates (e.g., every 10 minutes instead of every minute)

Summary

Integrating Smiirl with Hubhus allows you to display real-time business metrics on a physical counter that motivates your team and impresses visitors. By combining Hubhus HTML components, HTTP webhooks, and either action listeners or automation rules, you can create a dynamic counter that updates automatically based on your sales, leads, bookings, or any other metric that matters to your business. The key is to choose the right action (set vs increment) and trigger method (event-based vs scheduled) for your specific use case.

Common searches

smiirl setup • real-time counter • physical counter integration • webhook setup • counter api • display sales numbers

Also known as

physical counter • mechanical display • real-time dashboard • sales counter • live metrics • counter device

_Hubhus integrations overview
How do I create automation rules?
What are action listeners and how do they work?
API setup and authentication
Understanding the Hubhus data model