How to send your number to your Custom Counter via API, Make, n8n

You have a Custom Counter and a changing data source (orders, leads, coffees per hour, …) and you want the counter to update automatically.

Whether you use Make, n8n, a backend job, or plain JavaScript, you can push values to your counter with our API.

What you need

In my.smiirl.com, open your counter settings and select “PUSH Number” mode. In this mode you can update the counter from the dashboard or via the API using the following parameters:

Counter ID
Counter token
The value or action you want to send

Quick start

Works with anything that can make an HTTP GET request:

A webhook in Make or n8n
A cron job or serverless function
A simple fetch() in JavaScript

Base URL pattern:

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

{ACTION}: add-number , set-number , or reset-number
{VALUE}: required for add-number and set-number

Actions (endpoints)

Replace placeholders with your values:

{COUNTER_ID} → your Counter ID
{TOKEN} → your Counter token
{X} → a number

➕ Increment by 1 (e.g. new order)

<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/1>

➖ Decrement by 1 (e.g. refund)

<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/-1>

➕ Increment by X (dynamic)

<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/{X}>

➖ Decrement by X (dynamic)

<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/-{X}>

🎯 Set to an exact value

<http://api.smiirl.com/{COUNTER_ID}/set-number/{TOKEN}/{X}>

Replace {X} with the exact number you want shown.

🧼 Reset to 0

<http://api.smiirl.com/{COUNTER_ID}/reset-number/{TOKEN}>

Examples

JavaScript (fetch)

// Increment by 1
fetch('<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/1>')
  .then(r => r.text())
  .then(console.log)
  .catch(console.error);

// Set to an exact value
fetch('<http://api.smiirl.com/{COUNTER_ID}/set-number/{TOKEN}/{X}>')
  .then(r => r.text())
  .then(console.log)
  .catch(console.error);

cURL

# Decrement by 1
curl "<http://api.smiirl.com/{COUNTER_ID}/add-number/{TOKEN}/-1>"

# Reset to 0
curl "<http://api.smiirl.com/{COUNTER_ID}/reset-number/{TOKEN}>"

Tips

Keep your token secret. Avoid exposing it in public repos or client-side code when possible.
If you send multiple requests quickly, the counter processes them in order.
If nothing changes, confirm you are in "PUSH Number" mode and that the ID and token are correct.

If you have have any questions - please do not hesitate to reach out to us via support@smiirl.com, we will be glas to help :)