Skip to main content

Connecting your GivEnergy inverter via API

Obtaining a GivEnergy API Token

To connect your GivEnergy system to the Smug app, you'll need to generate an API token. This token allows secure communication between your inverter or battery and the app.

An API (Application Programming Interface) lets two programs talk to each other. For example, a weather app on your phone talks to a weather service's API to get a forecast. 

The API key (or sometimes token) is a unique code that tells the Smug what your system is doing. It's how the service knows you're allowed to use it, kind of like showing your ticket at a concert. It is a very secure way of connecting between two parties.

To access your API key and connect your GivEnergy inverter:

Step 1:

Visit your GivEnergy account and log in with your credentials.

Step 2:

Once logged in, navigate to your Account Settings. On desktop, this is in the left sidebar. On mobile, you'll find it at the bottom of the screen.

Account Settings

Step 3:

At the top right of the account details page, click on Manage Account Security.

Manage Account Security

Step 4:

Under the GivEnergy API Tokens section, click Generate New Token.

Generate New Token

Step 5:

Enter a name for your token (e.g., My GivEnergy Token). This could be something memorable, or random. 

Select "No Expiry" so that the connection remains active unless manually revoked. Smug won't work unless it is set to "No Expiry".

A pop-up will show, saying that it is strongly discouraged to generate an API token without an expiry. This is completely safe to do so for Smug - all the data is handled securely. 

image (13).png

Set Token Name

Step 6:

Select the following token scopes, then click Create Token:

  • api:inverter
  • api:site

Token Scopes

Step 7:

Once created, copy the token and store it in a secure location. GivEnergy only allows viewing it once.

Copy Token

Step 8:

You're all set! Paste the copied API token into the Smug app to complete the setup.

Back to top