Send a message to Kustom from the internet

Send a message to Kustom via HTTP POST #

Starting from version 3.70 you can send variables from the Internet directly to Kustom via HTTP POST. This could be useful in many situations like:

  • Sending data from your home automation back to your Widget / Wallpaper
  • Integrate with external systems like IFTT or public services
  • Receive alerts from some cloud based service

How do i find my token? #

To find your app token:
  • Go to Kustom app Settings
  • Press "Advanced Settings"
  • Select "Remote Message"
  • A dialog will appear, just press COPY

Does it work on AOSP/Huawei? #

No this function right now works only on Google version

Test with curl #

You can test this with CURL on your local machine, let’s say you want to set var foo to some value, then in Kustom you will use the formula $br(remote, foo)$, then use this command to change it:

curl -X POST https://api.kustom.rocks/msg \
  --header "Content-Type: application/json" \
  --data '{
    "tokens": [
      "your app token from kustom settings",
    ],
    "data": {
      "foo": "hello from remote!"
    }
  }'

Use with IFTT #

Let’s say for example that you want to update a widget every time Elon tweets, then:

  • Create a new IFTT task
  • Select Twitter as a trigger, new tweet from specific user, connect Twitter and proceed
  • Press “then” and select “WebHook” as a service
  • Press “make a web request”
  • In the URL field use https://api.kustom.rocks/msg
  • Select method “POST” and content type “application/json”
  • Finally in the body add following json:
{
  "tokens": [
    "your app token from kustom settings"
  ],
  "data": {
    "tweet": "{{Text}}"
  }
}

You are done! Just use $br(remote, tweet)$ in Kustom now and wait for the next tweet!

Fair use #

This API is currently rate limited you can do up to 5 calls per minute, you can see how many calls you have left by looking at the X-RateLimit-* headers during the call. I might increase / decrease this number based on usage.




Privacy Policy