PowerHQ Partner Network

PowerHQ iFrame — Partner Onboarding Guide

Everything you need to go from sign-up to live energy enrollment on your site — styled to your brand, with no engineering required. Answer the highlighted questions as you read — at the end of the page you'll review everything and submit it to your partner manager. Completing this form is the first step: once you submit, we send your agreement to sign. Your answers are saved in this browser as you go.

What you're getting

The PowerHQ iFrame embeds our proven energy shopping and enrollment experience directly into your website. Your visitors compare plans, sign up, and complete enrollment without leaving your site — PowerHQ handles the supplier relationships, regulatory and compliance layer, enrollment operations, and customer service behind the scenes.

All deregulated states, dynamically supported. The experience automatically adapts to the customer's market.
Residential and business customers. Both are supported by default; you can choose to support only one customer type.
Your brand. We configure fonts and colors to match your site, and emails can carry your name.
Built for conversion. A personalized, continually optimized UX that routes each customer to the right shopping path.

Onboarding at a glance

1
Complete this formYou're here
Answer the questions on this page, then submit at the bottom.
2
Sign the agreement
We send it for signature once you submit this form.
3
We set you up
4
Test links + IP whitelist
5
You test
6
Go live

Typical timeline: live in days, not months.

1Complete this set-up form

Start here. Work through the highlighted questions on this page, then review and submit at the bottom. Submitting this form is what kicks everything off: as soon as it's in, your PowerHQ partner manager prepares your agreement and sends it to you for signature.

2Sign the partner agreement

Signing the partner agreement is required before you can go live. Once you submit the form above, your partner manager sends the agreement — including Exhibit A, which sets your compensation terms — for your review and signature. Formal onboarding begins the moment it's signed, and your PowerHQ contact kicks off setup immediately after.

3We set up your partner profile

PowerHQ configures your experience — there's nothing for your engineering team to build. Answer the questions in each block and we'll have what we need.

Branding

We apply your font and colors to the embedded experience so it looks native to your site.

Your set-up — branding

Brand color

Font used on your site

Tip: this page previews your choices — the green accents will switch to your brand color, and the page text will switch to your font.

Email sender name

Customer emails (order confirmations, enrollment updates) can be sent under a custom email name of your choosing. The default sender is PowerHQ.

Your set-up — email sender

PowerHQDefault sender name Custom nameYour brand on customer emails

Partner codes — parent and child

You receive a unique partner code. If you want to track activity separately — by site, channel, campaign group, or sub-brand — we can set up a parent code with multiple child codes. Every conversion is reported with the code (parent or child) that produced it.

Your set-up — partner codes

Single codeOne code for everything Parent + childrenTrack segments separately

Customer types

By default your iFrame supports both residential and business customers. If you prefer to serve only one customer type, we configure that — or you can use the type-specific links below to control it per placement.

Your set-up — customer experience

BothResidential + business (default) Business only Residential only

4Receive your test links & whitelist your IPs

We provide links to our test environment so you can experience exactly what your customers will see.

IP whitelisting required: the test environment is access-restricted. Send us the IP address(es) your team will test from and we'll whitelist them before you begin.

Your set-up — test access

IP address(es) to whitelist *

How the link is structured

Every iFrame link follows the same structure — we'll send yours pre-built, but here's what each piece does:

https://www.dev.powerhq.co/partner-app.html?utm_source=[PARTNER_CODE]&utm_medium=referral&utm_campaign=[CAMPAIGN]#/[partner_code]?ftype=DEFAULT_PARTNER&service_type=[TYPE]&zip_code=[ZIP]

Piece	What it does
`utm_source=[PARTNER_CODE]`	Your assigned partner code (parent or child). Identifies you on every conversion.
`utm_medium=referral`	Fixed — leave as is.
`utm_campaign=[CAMPAIGN]`	Any value you choose for marketing attribution — passed through to your reports. See Reporting below.
`#/[partner_code]`	Your partner code again, lowercase.
`ftype=DEFAULT_PARTNER`	Fixed — leave as is.
`&service_type=[TYPE]` (optional)	`BUSINESS` or `RESIDENTIAL` to limit a placement to one customer type. Omit to support both.
`&zip_code=[ZIP]` (optional)	Pre-loads a zip code you've already collected on your site. See Embedding tips.

You can place links with different parameters in different parts of your site — e.g., business-only on your commercial pages, residential-only on your consumer pages. Production links use the same structure on the production domain.

Embedding tips

Set the iFrame width to 100%

The experience is responsive to different screen sizes, so we recommend width="100%" — it will adapt automatically to desktop, tablet, and mobile.

Pre-loading a zip code

If you already collect a zip code on your site, pass it into the iFrame so the customer doesn't have to enter it again. Just append the following to the end of the iFrame URL:

&zip_code=[zipcode]

For example, if the zip code is 75035, add &zip_code=75035. The full URL would look like:

https://www.powerhq.co/partner-app.html?utm_source=[PARTNER_CODE]&utm_medium=referral&utm_campaign=[CAMPAIGN]#/[partner_code]?ftype=DEFAULT_PARTNER&service_type=RESIDENTIAL&zip_code=75035

This pre-loads the zip code for the user, dropping them straight into plan results for their area.

Your set-up — zip code

Will you pass a zip code into the iFrame?

5Test the experience

Place the iFrame on a staging page (or open the link directly) and run through the shopping and enrollment flow as a customer would. Confirm:

The iFrame displays correctly at width="100%" across desktop and mobile
Zip code pre-loading works if you're passing &zip_code= from your site
Branding (font, colors) looks right within your site
The correct customer type(s) appear for each placement
Your partner code and utm_campaign values flow through to the daily conversion file

Your PowerHQ contact will work with you through any adjustments.

6Go live

Once you've tested successfully, we provide your production link(s) — same structure, production domain. You can go live immediately.

Reporting & attribution

You'll receive three reports:

Report	What it gives you	Cadence
PostHog dashboard	Live funnel and traffic analytics for your experience. Example dashboard	Real-time
Daily conversion file	Every conversion with order details, your partner code (parent or child), and the `utm_campaign` value — designed for marketing attribution.	Daily
Monthly commission report	Detail on every conversion and the payments owed to you, including partner code and `utm_campaign`.	Monthly

Daily conversion file — fields

Order ID, Conversion DateTime, Estimated Conversion Value, Customer Name, UTM Campaign, Referral Code (your partner code), Term Length, Start Date, Annual Usage, Customer Type (RESIDENTIAL / BUSINESS).

Attribution tip: whatever value is in utm_campaign at conversion is passed through to the daily conversion file and commission report. Partners use this two ways: some pass the marketing campaign info directly (campaign name, placement, ad set), while others pass a unique ID and match it back to the marketing source in their own systems. Either works — use whatever fits your attribution setup. Combine with child codes for a second tracking dimension.

Your set-up — attribution

How will you use utm_campaign?

Campaign infoCampaign name / placement / ad set in the parameter Unique IDWe'll match IDs to sources in our own systems Not sure yetWe'll figure it out during testing

Complete your set-up

Just what we need to prepare your agreement.

Company details

Company legal name *

Company address

Main telephone

Website address *

Authorized signatory

The person who will sign the partner agreement on behalf of your company.

Name *

Position / title

Phone

Email *

Payment details come later. Your partner manager will collect your banking information and W-9 through a secure channel before your first commission payment — no need to provide them here.

Anything else?

Notes for your partner manager — optional

Review & submit

Everything you've answered throughout this page, in one place. Review it, then hit Submit to send it to your PowerHQ partner manager.