How to get your Octopus Energy API key and account number

To connect your Octopus Energy tariff to 1app.energy, we need two things from your Octopus account:

1. Your account number (looks like A-XXXXXXXX)
2. Your API key (looks like sk_live_...)

Both live inside your Octopus online account and take about a minute to grab. Here is the exact path.

Why we need these

1app.energy uses your API key to read your tariff, your half-hourly import and export rates, and (for Agile/Tracker customers) the rates published for the day ahead. That is what lets us coordinate your battery and EV charging against the cheapest windows automatically.

The API key acts like a read-only password to your Octopus account, so treat it as a secret. We store it encrypted and only use it to talk to Octopus on your behalf.

Before you start

• Use the Octopus account that holds the electricity supply for the home you are setting up. If your gas and electricity sit on different accounts, the electricity one is the one we need.
• This is the customer account at octopus.energy — not the Octopus Intelligent Go app login. (If you are on Intelligent Go, we will ask for that login as a separate step inside 1app.energy, after the tariff connects.)

Step 1 — Find your account number

Log in to octopus.energy. On the home screen you will see a greeting ("Hi [your name]") and, just below it, your account number in the form A-XXXXXXXX.

Copy that number — you will paste it into 1app.energy alongside the API key.

Step 2 — Open Personal details

Click the Personal details link directly under your account number. This takes you to Your settings.

Step 3 — Open Developer settings

On the Your settings page you will see four panels: Your contact details, Your password, Your communication preferences, and Developer settings.

In the Developer settings panel, click API access.

Step 4 — Copy your API key

You land on the API access page. Scroll down to the Generate an API Key section.

Your existing key is shown next to Your API key, starting with sk_live_. Click into the box to select it, then copy it.

If you have never used the API before, the field will already contain a key — Octopus generates one automatically for every account. There is nothing to enable.

Important: Octopus only displays the full key once after each generation. If yours has already been shown to you and copied elsewhere, the safest path is to click Regenerate my API key and use the fresh one. Be aware regenerating invalidates the old key, so any other tool using it will need updating too.

Step 5 — Paste both values into 1app.energy

In 1app.energy, go to Settings → Devices, choose Octopus Energy, and paste in:

• The API key from Step 4 (sk_live_...)
• The account number from Step 1 (A-XXXXXXXX)

We immediately call the Octopus API to read your tariff. Within a few seconds your current tariff name, unit rates, and (for Agile/Tracker) day-ahead pricing will appear on your dashboard.

Step 6 — Octopus Intelligent Go customers only

If your tariff is Octopus Intelligent Go, your smart-charge slots are not exposed via the standard API key — they live in the Intelligent Go mobile app. After the tariff connects, 1app.energy will prompt you for your Intelligent Go email and password as a separate step. That lets us read the slot schedule Octopus has assigned to your car and protect your home battery from being drained during those slots.

You can read more on why this matters here: Why Octopus drains your home battery.

If something goes wrong

• "Invalid API key" on save — most often a stray space when copying. Re-copy directly from the Octopus page.
• Account number rejected — make sure you include the A- prefix and use the electricity account, not gas.
• Key was working then stopped — somebody (you, or another tool) clicked Regenerate my API key, which invalidates the previous one. Grab the fresh one and paste it back into 1app.energy.
• Two homes on one Octopus account — email us at support@1app.energy; we handle multi-property accounts case-by-case.

A note on safety

Your Octopus API key gives read access to your account, including consumption data and tariff details. Treat it like a password:

• Do not paste it into chat with strangers, screenshots, or public forums.
• If you ever suspect it has leaked, click Regenerate my API key in Octopus and re-enter the new one in 1app.energy.

We never share your key with third parties, and revoking us is as simple as regenerating the key on Octopus's side.

More setup guides

Setting up other devices in 1app.energy at the same time? See:

• How to get your SolisCloud API key — for Solis hybrid inverters
• How to get your myenergi API key for your Zappi — for Zappi EV chargers
• All device setup guides — full list

Need a hand? Reach out from the support@1app.energy inside the app and we will help you connect.