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 1app.energy needs your Octopus API key

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 tariff context can help supported homes coordinate battery and EV charging around cheaper windows where the customer enables control.

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 get your Octopus API key

• 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.

Many customer accounts already show an API key in this section. There is usually nothing else 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)

After you save the details, 1app.energy checks the Octopus API and reads the tariff data available for your account. When the connection verifies, 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, 1app.energy can use your saved Octopus API key to sync the smart-charge slots Octopus has assigned to your EV. Where supported, that helps stop a verified controllable battery from discharging into those sessions.

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

Troubleshooting Octopus API key setup

• "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.

Octopus API key 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.

Common questions about the Octopus Energy API key

Is my Octopus API key the same as my Octopus password?

No. Your Octopus API key is separate from your account password. It is used by apps and tools to read account and tariff data through the Octopus API.

Does 1app.energy need my Octopus login password?

No. For tariff data, 1app.energy asks for the Octopus account number and API key. Intelligent Octopus Go customers may have a separate smart-charging connection step, but that is not the same as this tariff API setup.

Can an Octopus API key change my tariff or switch my supply?

No. The standard Octopus API key is used for account and energy data access. 1app.energy uses it to read tariff, rate and usage context so supported homes can make better battery and EV decisions.

What happens if I regenerate my Octopus API key?

The old key stops working. If another tool, script or app used the old key, you will need to update that tool as well as 1app.energy with the new key.

Why does 1app.energy need both the API key and account number?

The account number identifies the Octopus account to read, and the API key proves that you are allowed to access it. Both are needed so the connection can be checked safely.

Sources checked on 17 June 2026

• Octopus Energy API documentation, for the API authentication model.
• Octopus Energy customer account, for the current customer-account route to personal details and developer settings.

More setup guides

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

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

Setting up 1app.energy for the first time? Visit 1app.energy/signup to start onboarding, or email support@1app.energy if you need help connecting Octopus.