# Enphase Integration Setup Learn how to connect your Enphase systems to Powerlily for real-time monitoring and fleet management. This guide walks you through creating a developer account with Enphase and obtaining the credentials needed to sync your systems. ## Overview Powerlily uses a **BYO API Key (Bring Your Own)** approach for Enphase integration. This means: - **You create your own Enphase developer account** - Free to set up - **You control your API costs** - You pay Enphase directly based on your usage - **Full access to your system data** - Direct connection to Enphase Enlighten This approach gives you complete control and transparency over your API usage and costs. ## What You'll Need To connect Enphase systems to Powerlily, you'll need five pieces of information: 1. **Enlighten Manager Username** - Your Enphase Enlighten email 2. **Enlighten Manager Password** - Your Enphase Enlighten password 3. **Enphase API Key** - Generated when you create an application 4. **Client ID** - Generated when you create an application 5. **Client Secret** - Generated when you create an application Don't worry - the setup process is straightforward! Follow the steps below to get everything configured. ## Step-by-Step Setup ### Step 1: Create an Enphase Developer Account First, you'll need to register for a free developer account with Enphase. 1. Visit the [Enphase Developer Portal](https://developer-v4.enphase.com/) 2. Click **Sign Up** in the top right corner 3. Fill in the required information: - Email address - Password - Company name - Contact information 4. Submit the registration form 5. Check your email for the activation link 6. Click the activation link to verify your account **Note:** By creating an account, you agree to the Enphase Energy API License Agreement. ### Step 2: Log In to the Developer Portal Once your account is activated: 1. Go to [https://developer-v4.enphase.com/](https://developer-v4.enphase.com/) 2. Click **Sign In** 3. Enter your credentials 4. You'll be taken to the developer dashboard ### Step 3: Create an Application Now you'll create an "application" in the Enphase portal. This generates the credentials you need. 1. From the developer dashboard, navigate to the **Applications** page 2. Click **Create New Application** (or similar button) 3. Fill in the application details: #### Application Fields **Plan** - Choose your subscription tier: - **Watt Plan** (Free) - Limited endpoints, lower rate limits, good for testing - **Kilowatt Plan** (Paid) - More endpoints including device-level monitoring - **Megawatt Plan** (Paid) - Higher rate limits for large fleets For most installers monitoring customer systems, the **Watt plan** is sufficient to get started. You can always upgrade later. **Name** - Enter a descriptive name: - Example: "Your Company Name - Powerlily Integration" - This name is shown to homeowners when they authorize access - Make it professional and recognizable **Description** - Explain what the application does: - Example: "System monitoring and performance tracking for our solar installations" - This helps homeowners understand why you're requesting access **Developed By** - Your company name: - This appears in the Enphase App when systems are connected **Access Control** - Select the data you need access to: - For basic monitoring, select: - ✅ **System Details** - Basic system information - ✅ **Site Level Production Monitoring** - Energy production data - ✅ **Site Level Consumption Monitoring** - Energy usage data (if applicable) - The available options depend on your selected plan 4. Click **Create Application** to generate your credentials **Note:** For paid plans (Kilowatt/Megawatt), you'll need to enter payment information. ### Step 4: Retrieve Your Credentials After creating the application, you'll see your credentials on the Applications page: 1. Click on your newly created application 2. You'll see four important pieces of information: #### Your API Credentials **API Key** - A long alphanumeric string - Example: `f2a479f3c6067f0d9517cadae7f00b47` - Used to authenticate every API request **Auth URL** - The authorization endpoint - Example: `https://api.enphaseenergy.com/oauth/authorize?response_type=code&client_id=...` - You won't need this URL directly in Powerlily, but it's used in the authorization flow **Client ID** - A unique identifier for your application - Example: `f2a479f3c6067f0d9517cadae7f00b47` - Used during the OAuth authentication process **Client Secret** - A private key for your application - Example: `dcdad1f5cd4132ca537f72664dbf3104` - **Keep this confidential!** Never share it publicly **Important:** Copy these credentials and store them securely. You'll enter them into Powerlily in the next step. ### Step 5: Enter Credentials in Powerlily Now you'll connect Enphase to Powerlily: 1. Log in to your Powerlily account 2. Navigate to **Settings** → **Integrations** (or **Company Settings** → **Integrations**) 3. Find the **Enphase** section 4. Enter your credentials: **Field** | **What to Enter** --- | --- Enlighten Manager Username | Your Enphase Enlighten email address Enlighten Manager Password | Your Enphase Enlighten password Enphase API Key | The API Key from your application Client ID | The Client ID from your application Client Secret | The Client Secret from your application 5. Click **Save** or **Connect Enphase** 6. Powerlily will test the connection 7. If successful, you'll see a confirmation message **Troubleshooting:** If the connection fails, double-check that: - All five credentials are entered correctly (no extra spaces) - You're using the correct Enlighten Manager username (email) and password - Your Enphase application is active (not in pending state) - You've selected the correct access controls in your Enphase application ### Step 6: Authorize Systems After connecting your Enphase credentials, you'll need to authorize access to specific systems: #### For Your Own Systems If you're the system owner in Enphase Enlighten: 1. The systems should appear automatically in Powerlily 2. Navigate to **Fleet Management** to view them 3. Data should start syncing within a few minutes #### For Customer Systems If you need to monitor systems owned by your customers: 1. You'll need each homeowner to authorize access 2. Enphase uses an OAuth flow where homeowners grant permission 3. There are two ways to handle this: **Option A: Share Authorization Link** - Generate an authorization link in Powerlily (if available) - Send it to your customer via email - Customer clicks the link, logs in to Enlighten, and approves access **Option B: Manual Authorization** - Customer logs into their Enphase Enlighten account - Customer navigates to settings and finds authorized applications - Customer authorizes your application by name **Note:** The exact authorization process depends on how Powerlily implements the OAuth flow. Check the Fleet Management dashboard for specific instructions on adding customer systems. ## Understanding Enphase Plans ### Watt Plan (Free) - **Cost:** Free - **Rate Limits:** Lower request limits - **Access:** - System details - Site-level production monitoring - Site-level consumption monitoring - **Best For:** Small installers, testing, limited monitoring needs ### Kilowatt Plan (Paid) - **Cost:** Pay per usage (see Enphase pricing) - **Rate Limits:** Higher than Watt plan - **Access:** - Everything in Watt plan - Device-level production data (per panel/microinverter) - Streaming APIs - **Best For:** Growing installers needing detailed diagnostics ### Megawatt Plan (Paid) - **Cost:** Pay per usage (see Enphase pricing) - **Rate Limits:** Highest limits - **Access:** - Everything in Kilowatt plan - Higher API call allowances - **Best For:** Large installers with extensive fleets ### Partner Plan (Paid) - **Cost:** Custom pricing - **Requirements:** Registered Enphase installer with 10+ installations - **Access:** - All Monitoring API endpoints - All Commissioning API endpoints - Ability to create and update activations - Manage companies and users - **Best For:** Official Enphase installer partners **Note:** You can start with the free Watt plan and upgrade as your monitoring needs grow. ## API Authentication Flow Here's what happens behind the scenes when Powerlily connects to Enphase: 1. **Initial Connection** - Powerlily uses your Client ID and Client Secret to authenticate 2. **Token Generation** - Enphase generates an OAuth2 access token 3. **Data Requests** - Powerlily makes API calls using the access token and API Key 4. **Token Refresh** - Access tokens expire after 1 day and are automatically refreshed 5. **Continuous Sync** - System data is retrieved and updated regularly You don't need to manage this process manually - Powerlily handles token refresh and authentication automatically once you've entered your credentials. ## Security Best Practices ### Keep Credentials Secure - **Never share your Client Secret** publicly or in client-facing materials - Store credentials in a secure password manager - Don't commit credentials to version control systems ### Use Strong Passwords - Use a strong, unique password for your Enphase developer account - Enable two-factor authentication if available - Don't reuse passwords from other services ### Monitor API Usage - Check your Enphase developer dashboard regularly - Review API call volumes and costs - Set up billing alerts if available ### Limit Access Scope - Only request the access controls (scopes) you actually need - Use the minimum plan tier for your requirements - Review authorized systems periodically ## Troubleshooting ### "Invalid Credentials" Error **Problem:** Powerlily can't connect to Enphase **Solutions:** - Verify all five credentials are entered correctly - Check for extra spaces before/after credentials - Ensure you're using your Enlighten email (not developer portal email) - Confirm your Enlighten password is correct - Make sure your Enphase application status is "Active" not "Pending" ### "No Systems Found" **Problem:** Connection works but no systems appear **Solutions:** - Verify you have systems associated with your Enlighten account - Check that systems are online in Enlighten Manager - Ensure you've selected the correct access controls in your application - Wait 15-30 minutes for initial sync to complete - Try disconnecting and reconnecting the integration ### "Rate Limit Exceeded" **Problem:** Too many API requests **Solutions:** - Upgrade to a higher plan (Kilowatt or Megawatt) - Reduce monitoring frequency if configurable - Check if multiple integrations are using the same credentials - Contact Enphase support for rate limit details ### "Authorization Code Expired" **Problem:** OAuth tokens are invalid **Solutions:** - Powerlily should auto-refresh tokens (access token = 1 day, refresh token = 1 month) - If issue persists, disconnect and reconnect the integration - Generate new credentials from Enphase and re-enter in Powerlily ### "Application Pending" **Problem:** Your Enphase application isn't activated yet **Solutions:** - Check your email for activation instructions from Enphase - For partner plans, verification may take 1-2 business days - Contact Enphase developer support if pending more than 48 hours ## Costs and Billing ### What You Pay Enphase API costs are based on your selected plan: - **Watt Plan:** Free (limited usage) - **Kilowatt Plan:** Pay-per-use pricing (check Enphase pricing page) - **Megawatt Plan:** Pay-per-use pricing (check Enphase pricing page) - **Partner Plan:** Custom contract pricing ### Monitoring Costs - Most plans charge based on number of API calls - System monitoring typically results in predictable monthly costs - You can track usage in the Enphase developer dashboard ### Payment - For paid plans, enter credit card details in Enphase portal - Billing is handled directly by Enphase (not through Powerlily) - You'll receive invoices from Enphase monthly **Note:** Powerlily does not mark up or add fees to Enphase API costs. You pay Enphase's standard rates. ## FAQ ### Do I need a separate account for each installer/user? No - you create one Enphase developer account and application, then enter those credentials into Powerlily. All users in your Powerlily account will share the same Enphase integration. ### Can I use the same credentials in multiple tools? Technically yes, but be aware: - All tools share the same rate limits - API usage from all sources counts toward your plan limits - This can lead to "rate limit exceeded" errors - Best practice: create separate applications for different tools ### What happens if my access token expires? Powerlily automatically refreshes tokens before they expire. Access tokens last 1 day, refresh tokens last 1 month. As long as your credentials are valid, the integration continues working seamlessly. ### Can I monitor systems I didn't install? Yes, but you need the system owner's authorization. The homeowner must log into their Enphase Enlighten account and approve your application's access to their system data. ### How often does Powerlily sync data from Enphase? This depends on Powerlily's configuration, but typically: - Real-time data: Every 5-15 minutes - Historical data: Daily - System status: Every 15-30 minutes Check the Fleet Management settings for exact sync intervals. ### Do I need different credentials for production vs. development? The Enphase developer portal is the production environment. There's no separate staging/development environment. However, you can create multiple applications (e.g., "Company Name - Testing" and "Company Name - Production") with different credentials. ### What if I change my Enlighten password? If you change your Enlighten Manager password, you'll need to update it in Powerlily: 1. Go to Settings → Integrations 2. Update the "Enlighten Manager Password" field 3. Save the changes ### Can I revoke access to specific systems? Yes, system owners can revoke access at any time: - They log into Enphase Enlighten - Navigate to authorized applications - Remove your application You can also manage authorized systems from your Enphase developer dashboard. ## Additional Resources ### Enphase Documentation - [Enphase Developer Portal](https://developer-v4.enphase.com/) - [Quick Start Guide](https://developer-v4.enphase.com/docs/quickstart.html) - [API Documentation](https://developer-v4.enphase.com/docs) - [Release Notes](https://developer-v4.enphase.com/docs/release-notes.html) ### Enphase Support - Developer support email: [[email protected]](mailto:[email protected]) - Support portal: Available through developer dashboard ### Powerlily Support - Email: [[email protected]](mailto:[email protected]) - Need help with integration? Contact us for personalized assistance --- **Next Steps:** - [[Fleet Management/Overview|Return to Fleet Management Overview]] - Learn about [[Client Portal/Monitoring|sharing monitoring data with customers]] - Set up [[Fleet Management/Overview#Automated Alerts|automated system alerts]]