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? #

Your Token

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.