Mysa Consumer API: Getting Started

Last updated: November 14, 2026

The Mysa Consumer API lets you connect your own app, script, or AI assistant to the Mysa thermostats you can access in your Mysa account. Access is granted through Mysa sign-in and an approval step, so you should never share your Mysa password with another app or developer.

Who this is for

This API is intended for developers and technically comfortable customers who want to build personal integrations with their Mysa devices.

What is available

  • Example projects for curl, Python, and TypeScript.

  • OAuth 2.0 PKCE sign-in examples.

  • Examples for reading and controlling supported thermostats that your Mysa account can access.

  • An OpenAPI reference for developers building against the API.

Get started

  1. Open the public examples repo: github.com/empoweredhomes/mysa-api-examples.

  2. Review the README and choose the example that matches your environment: curl, Python, or TypeScript.

  3. Follow the OAuth 2.0 PKCE sign-in flow in the repo. You will sign in with Mysa and approve access before the example can access your thermostats.

  4. Use the OpenAPI reference and examples to build your integration.

Security reminders

  • Do not share your Mysa password with any third-party app, developer, support agent, or community member.

  • Do not paste access tokens, refresh tokens, client secrets, or API credentials into support tickets, public forums, GitHub issues, or Slack/Discord communities.

  • If you believe a token or integration has been exposed or misused, contact support@getmysa.com right away.

Support scope

Mysa Support can help route API access, disconnect, or suspected abuse questions to the API team. We may not be able to debug custom code, third-party automations, or unsupported community integrations line-by-line.

When contacting Support about an API integration, include:

  • The app or project name.

  • Your developer contact email.

  • The redirect URI or URIs you want to use, copied exactly.

  • A short description of what your integration needs to do.

  • Whether the integration is an AI assistant, such as Claude, ChatGPT, Cursor, or similar.

Need help?

Email support@getmysa.com and include the details above. Do not include passwords, tokens, refresh tokens, or secrets.