Skip to content

OAuth 2.0 authentication

Kristel edited this page Dec 28, 2024 · 1 revision

OAuth 2.0 authentication

Basics

The only authentication mechanism supported by the tado API is OAuth 2.0.

tadoº only supports OAuth 2.0 authentication via their own authentication server; the API does not support third party authentication methods.

There are several pieces of information you need to authenticate via OAuth 2.0:

  • client id: public-api-preview (as mentioned in [1])
  • client secret: 4HJGRffVR8xb3XdEUQpjgZ1VplJi6Xgw (a publicly shared 'secret' as mentioned in [1])
  • authorization grant type: password
  • token URI: https://auth.tado.com/oauth/token
  • username: the username of your tado account
  • password: the password of your tado account

(the tado OAuth 2.0 set-up does not use scopes)

Here are some resources to help you to successfully authenticate to the tado API.

About client_id and client_secret

Please note that the official tado article [1] explicitly states "Also, feel free to share the client credentials with other developers. That way we will be able to easily distinguish our own apps from third party developers." So use the client id and client secret as provided on that page.

Article [2] mentions that you can visit https://my.tado.com/webapp/env.js to obtain a valid client_id and client_secret. The approach described on that page will work, but it will not allow tado to distinguish the traffic from their own apps from other traffic.