What is an invitation?
An invitation is a shareable link you send to whoever will connect the utility account — by email, chat, or embedded in your own product. When the recipient clicks it, they see a secure page where they can log into their utility account on their own. Nectar handles everything behind the scenes: capturing the login, setting up the connection, and starting to collect bills automatically. The key parts:- They don’t need a Nectar login. No downloads, no account creation.
- You don’t see their password. They enter credentials directly into Nectar’s secure page.
- You stay in control. Every invitation is tracked, revocable, and time-bound.
Two types of invitations
| Type | What it does | When to use it |
|---|---|---|
| Contributor invitation | Creates a new connection for a company. | Onboarding a new utility account for the first time. Your recipient picks the provider, signs in, and Nectar starts collecting data. |
| Reconnect invitation | Updates an existing connection. | A connection hit an error (password changed, MFA token expired) and you want the account owner to re-enter credentials or refresh MFA forwarding. Preserves all historical data and site associations. |
Why use invitations instead of sharing credentials?
Two common situations where invitations are the best approach: You don’t have the utility login yet. Instead of asking for a username and password by email (which can feel uncomfortable for both sides), send an invitation. The recipient enters their own credentials directly into the secure page — you never see the password. The account owner prefers to enter credentials themselves. Some organizations — especially larger enterprises or those with strict security policies — don’t want to share login information with a third party. Invitations let them stay in control while still getting the benefit of automated data collection.Why invitations instead of magic links?
Invitations are a drop-in replacement for magic links with several additional guarantees:| Capability | Invitations | Magic links (legacy) |
|---|---|---|
| Activity log per recipient | Yes | No |
| Revoke an active link | Yes | No |
| Limit who can accept (by email) | Yes | No |
| Configurable expiration | Yes | Limited |
| Resend the invitation email | Yes | No |
| Track completion status in Nectar | Yes | Only via connection |
| Managed from a single admin screen | Yes | No |
What the recipient sees
When someone opens an invitation, here’s the experience step by step:They verify their email (optional)
They confirm the utility provider
They sign into their utility account
They select sites and utility types
How to create an invitation
From the Nectar platform
Open the Invitations page
Pick the flow
Configure access and prefill
Choose delivery
From the API
Developers can create invitations programmatically — including pre-filled contributor invitations and reconnect invitations — without going through the platform UI.Managing invitations
Open Data Input > Invitations to see every invitation for your company.- Active, Expired, Revoked, Fulfilled — filter by status to see what’s still outstanding.
- Copy link — grab the
https://dash.nectarclimate.com/p/i/{token}URL to share in a different channel. - Resend email — send the invitation email again (useful if the recipient lost it or if it landed in spam).
- Revoke — immediately invalidate an invitation. Anyone who tries to use the link after revocation sees a clear error.
- Activity log — see when the invitation was viewed, when email verification happened, and when the recipient submitted the flow. Useful when a recipient says “I never got it” or “it said the link was invalid.”
- Linked connections — for contributor invitations, see every connection created by that invitation.
White-label branding
If your company has white-label branding configured, invitation pages automatically display your brand — your logo, your colors, your fonts. Recipients never see “Nectar” anywhere. It looks like a seamless part of your own platform. This is especially powerful if you embed invitations in your own website or application. Recipients get a branded, professional experience that feels native to your product. See White-label for setup details.Tips for using invitations effectively
- Use Nectar-sent email when you can. The recipient gets a single click-to-start link and skips the email verification step.
- Restrict by email for shared inboxes. If you’re sending a link to a building manager at
[email protected], adding that email to the allow-list means the link only works when someone on that inbox clicks it. - Set a short expiration for reconnects. Credential-fix invitations are usually time-sensitive; a 7-day expiration keeps stale links from lingering.
- Set max uses for contributor invitations. If the invitation is for one account, cap it at 1 use to prevent accidental duplicates.
- Revoke instead of deleting. If a link is compromised or no longer needed, revoking it leaves the activity log intact so you can audit what happened.
FAQ
Can I send an invitation via email?
Can I send an invitation via email?
How long is the invitation valid?
How long is the invitation valid?
What does the recipient need to do?
What does the recipient need to do?
What if the recipient has trouble signing in?
What if the recipient has trouble signing in?
Is it safe to share invitation links?
Is it safe to share invitation links?
Can I customize what the invitation page looks like?
Can I customize what the invitation page looks like?
Do invitations work on mobile?
Do invitations work on mobile?
Can one invitation cover multiple sites?
Can one invitation cover multiple sites?
What happens after the recipient finishes?
What happens after the recipient finishes?
Can I see if someone used the invitation?
Can I see if someone used the invitation?
What if they accidentally close the page before finishing?
What if they accidentally close the page before finishing?
Can I use invitations for utility accounts outside the US?
Can I use invitations for utility accounts outside the US?
I was using magic links — do I need to change anything?
I was using magic links — do I need to change anything?