Video walkthrough coming soon. A Loom video demonstrating this feature will be added here.
What is a connection?
Think of a connection like setting up automatic bill pay at your bank — except instead of paying bills, Nectar is downloading and reading them for you. You give Nectar the login credentials for a utility website (like ConEdison, PG&E, or Duke Energy), and Nectar logs in on your behalf every week to grab new bills and extract the data. Once a connection is set up, you never have to visit that utility website again. Nectar handles it all: finding new bills, downloading the PDFs, reading them with AI, and filing the data in the right place. It’s the core of how Nectar works, and it’s what saves most customers dozens of hours every month.Screenshot coming soon. A screenshot of this feature will be added here.
How to create a connection
Choose your utility provider
Go to Data Input > Connections and click Online Accounts (or Connect account). Search for your utility company by name or URL — Nectar supports thousands of providers. For example, type “ConEdison” or “Pacific Gas” and select the right one from the list. If your provider isn’t listed, you can enter custom provider details manually.
Enter the login credentials
Enter the username and password that you (or your client) use to sign into the utility website. This is the same login you’d use if you were downloading a bill yourself. If the utility requires a text message code or authenticator app, you’ll complete that step here too.
Configure your settings
Tell Nectar how to handle the data: which sites the account covers, what type of utility it is, and how far back to collect bills. See the detailed breakdown of each setting below.
Configuration settings explained
When you create a connection, the configuration step has several settings that control how Nectar collects and processes data. Here’s what each one means in plain terms:Sites
Which of your buildings does this utility account serve? For example, if your ConEdison login covers both your Manhattan and Brooklyn offices, select both sites. This tells Nectar where to file the bills and usage data. If you’re not sure which sites an account covers, it’s fine to select your best guess — you can always reassign data later.Datasource types
What types of utility service does this account cover? Most utility accounts are straightforward — just electricity, or just natural gas. But some combined accounts cover multiple services (like electricity and gas on the same bill). Select all the types that apply: Electricity, Gas, Water, Waste, Fuel, Solar, or District (steam, chilled water, hot water). Nectar will only process bills that match your selections.Data collection start date
How far back should Nectar look for bills? You have three choices:| Mode | When to use it | Example |
|---|---|---|
| Company default | Use whatever start date your company is configured with. Good for keeping all your connections consistent. | Your company default is set to January 2023, so every new connection pulls bills back to that date. |
| Current month | Only collect bills from this month forward. Good if you only care about future data and don’t need historical bills. | It’s March 2026 — Nectar will only grab bills from March onward. |
| Custom date | Pick a specific date. Useful when you need historical data going back to a particular point. | You’re preparing a 2024 emissions report, so you set the start date to January 1, 2024. |
Multiply by occupancy
For shared buildings where you only lease a portion of the space. If you occupy 40% of a shared office building, this setting adjusts your usage numbers to reflect only your share. A bill showing 10,000 kWh would become 4,000 kWh in your reports. Leave this off if you fully occupy the building or if the utility account already reflects only your space.Custom container
For waste and fuel accounts only. If your waste hauler picks up a specific dumpster, or a fuel company delivers to a specific tank, enter the container details (name, size, and units) here. Nectar uses this information to calculate total consumption from delivery records. For example, if you have a 500-gallon propane tank and receive deliveries of 250 gallons at a time, Nectar can track your total fuel consumption accurately.Owner email
Who should receive notifications about this connection? Enter the email address of the person who manages this utility account. They’ll get notified if the connection encounters an error (like a changed password) or when new data is collected. Usually this is you, but for client accounts it might be the client’s facility manager.MFA requirement
Does this utility website require a security code to log in? Some utility portals send a text message code, use an authenticator app, or ask security questions during login. If yours does, check this box. Nectar will prompt you to complete the MFA challenge during setup, and you may need to re-complete it periodically.What to expect after connecting
- First data: Nectar typically completes the first collection within a few days. How many bills you get depends on the start date setting and how much history the utility portal makes available (most keep 12 to 24 months).
- Weekly checks: After the initial pull, Nectar checks the utility portal every week for new bills. You don’t need to do anything — new bills are downloaded and processed automatically.
- Notifications: The owner email receives updates when new data arrives or when an issue needs attention.
What to tell your client
If you’re an energy consultant connecting a client’s utility account, here’s a simple explanation you can share with them:“We use a platform called Nectar to automatically collect your utility data. We’ll need the login credentials for your utility website — the same username and password you’d use to view your bills online. Nectar logs in weekly to download new bills and extract the data. Your credentials are encrypted and stored securely. You can also connect the account yourself through a secure link we’ll send you.”If your client is uncomfortable sharing credentials directly, consider using a magic link instead — it lets them enter their own login without you ever seeing it.
Connection statuses
After creating a connection, its status tells you whether data is flowing smoothly or something needs your attention.| Status | What it means | What to do |
|---|---|---|
| Connected | Everything is working normally. Nectar is collecting data on its regular weekly schedule. | Nothing — you’re good. |
| Pending | The connection was just created and is waiting for its first collection run. | Sit tight. The initial run usually happens within a few days. |
| Under Investigation | The Nectar team is actively looking into an issue with this connection. | No action needed on your end. The team will resolve it or reach out if they need information. Contact support if you’d like an update. |
| Password Incorrect | The utility website rejected the login credentials. This usually means the password was changed recently. | Update the password using the Reconnect action. If your client changed their utility password, you’ll need the new one. |
| MFA Token Expired | A multi-factor authentication challenge needs to be completed — like entering a text message code. | Use the Reconnect action and complete the MFA step when prompted. |
| New Password Needed | The utility website is forcing a password reset before allowing login. | Go to the utility website directly, reset the password, then reconnect in Nectar with the new password. |
| Additional Credentials Needed | The portal is asking for extra verification — security questions, a PIN, or additional identity confirmation. | Use the Reconnect action and answer the prompts. |
| Website Down | The utility provider’s website is temporarily unavailable. | No action needed. Nectar will automatically retry on the next weekly check. This resolves on its own. |
| No Accounts Found | Nectar logged in successfully, but didn’t find any utility accounts in the portal. | Log into the utility website yourself and confirm accounts are visible. If they are, contact [email protected]. |
| URL Inaccessible | The utility portal URL is unreachable — the site may have moved, been taken down, or blocked Nectar’s requests. | Verify the URL still works in a browser. If it does, contact [email protected]. |
| Company Inactive | Your Nectar account has been deactivated, so connections cannot run. | Contact [email protected] to reactivate your account. |
| Other Error | Something unexpected happened that doesn’t fit the categories above. | Contact [email protected] with the connection name and company. |
Managing connections
Pause and resume — Need to temporarily stop data collection? Pause the connection. Maybe the client asked you to hold off, or you’re troubleshooting an issue. Resume whenever you’re ready. No data is lost. Archive — Done with a connection? Archive it. Archived connections stop collecting data and are hidden from the default connections list, but all their historical data stays intact. Think of it like moving a folder to storage — it’s out of sight but you can always pull it back. Reconnect — If a connection enters an error state (password changed, MFA expired, etc.), use the Reconnect action to update credentials. This is important: reconnecting preserves the link to all existing accounts, meters, and historical data. You don’t lose anything. Don’t create a new connection for the same utility account — always reconnect instead. Generate magic link — Need your client to connect their own account? Click the Generate magic link button at the top of the connections page. You can pre-fill the utility URL, sites, and utility types so your client has less to fill in. See Magic links for details.FAQ
Does Nectar store my client's password?
Does Nectar store my client's password?
Yes, but it’s encrypted. Nectar stores credentials using AES-128 encryption so it can log in to the utility portal on your behalf. The encrypted credentials are never visible to other users and cannot be retrieved in plain text — not even by Nectar staff. Nectar holds SOC 2 Type 1 and Type 2 certifications for security.
What happens if my client changes their password?
What happens if my client changes their password?
The connection will show a Password Incorrect status at the next weekly check. You’ll receive
an email notification. Use the Reconnect action to enter the new password. This is the most
common connection issue and takes about 30 seconds to fix.
Can I connect the same utility account twice?
Can I connect the same utility account twice?
You can, but you shouldn’t. Creating duplicate connections for the same utility login can result
in duplicate bills and confusion. If you need to change the configuration of an existing
connection, edit it directly rather than creating a new one.
How many connections can I have?
How many connections can I have?
There’s no hard limit on the number of connections. Nectar customers range from a handful of
connections to thousands. If you’re planning a large rollout, contact
[email protected] to discuss the best onboarding
approach.
What if the utility website changes its design?
What if the utility website changes its design?
Utility websites occasionally update their portals, which can temporarily disrupt connections.
Nectar’s engineering team monitors for these changes and typically updates support within days. If
your connection breaks after a utility portal redesign, it will show Under Investigation while
the team works on it.
How often does Nectar check for new bills?
How often does Nectar check for new bills?
Connections are checked on a weekly cycle. After each check, any new bills found are
downloaded and processed. Most utility companies post new bills monthly, so a weekly check ensures
Nectar grabs them promptly.
Why is my connection showing an error?
Why is my connection showing an error?
The most common causes are a changed password, an expired MFA token, or a temporary utility
website outage. Check the connection status for the specific error and follow the guidance in the
connection statuses table above. If the status says Under
Investigation, the Nectar team is already on it.
Can I connect utility accounts outside the US?
Can I connect utility accounts outside the US?
Yes. Nectar supports utility providers globally, including across Europe, Asia-Pacific, and other
international markets. The platform handles different date formats, currencies, and units of
measure. If your provider isn’t listed, contact
[email protected] to request it.
What does archiving a connection do?
What does archiving a connection do?
Archiving stops data collection and hides the connection from your default view — but all the
historical bills, meters, and usage data remain exactly where they are. You can unarchive a
connection later if you need to resume collection. Think of it as putting a subscription on hold
rather than canceling it.
How do I reconnect a failed connection?
How do I reconnect a failed connection?
Go to Data Input > Connections, find the connection with the error, and click on it to open the detail view. Use the Reconnect action to launch the credential update flow. Enter the updated username and password, complete any MFA steps, and submit. Nectar will attempt a new collection right away. All existing data is preserved.