Solar software connects in three ways. A direct API link moves data between cloud tools. A no-code middleware tool joins apps without custom code. Device protocols such as Modbus link field equipment. Most installers should start with one link, usually CRM to design tool, and name one system of record for each type of data.
An API (application programming interface) is a way for one program to ask another program for data, or to send it data. When your CRM, design tool and accounting app share data through APIs, nobody has to type the same customer twice. A CRM (customer relationship management tool) is where you store leads and deals.
This guide shows which links matter, which design tools publish an API, and what usually goes wrong. Plan sizes and prices change, so the vendor facts below name the page they came from.
Disclosure: SurgePV publishes this guide and sells solar design software. The tables list what each vendor says on its own site. They do not rank the tools.
In this guide:
- The three ways to connect solar software
- Where solar data lives and where it needs to move
- Which design tools publish an API, and on which plan
- A sample API request
- Protocols for inverters, meters and EV chargers
- Security basics and common mistakes
What Are the Three Ways to Connect Solar Software?
| Way to connect | What it is | Good for | Watch out for |
|---|---|---|---|
| Direct API link | Your own code, or a developer’s, calls the vendor’s API | Syncing CRM, design and accounting data | Needs a developer. Some vendors charge for API access |
| Middleware (iPaaS) | A no-code tool, such as Zapier, joins two apps | Simple one-way flows, like a new lead creating a new project | Weak at conflict rules and high data volume |
| Device protocol | A set of rules that lets field devices talk to a data system | Inverters, meters, plant controllers, EV chargers | Different from cloud APIs. Often runs on a private site network |
iPaaS stands for integration platform as a service. Zapier, for example, has app listings for HubSpot, Salesforce and QuickBooks.
Pick the simplest way that does the job. A built-in connector beats middleware. Middleware beats custom code.
Where Does Solar Data Live, and Where Must It Move?
A solar company often uses many tools. Each one creates data that another tool needs. The table shows the usual handoffs.
| System | Data it creates | Who needs it next |
|---|---|---|
| CRM | Leads, deals, appointments | Design tool, ERP |
| Design tool | System size, production estimate, bill of materials (BOM), proposal | CRM, ERP, permit tools |
| ERP (enterprise resource planning system) | Stock, purchase orders, money | CRM, design tool, project tools |
| Project tools | Tasks, schedules, field data | CRM, ERP |
| Monitoring | Production, alarms | Maintenance, CRM |
| Accounting | Invoices, payments | ERP, CRM |
Weather data is another input. Solargis sells solar data, software and services, and its homepage lists an Integrations product described as “Automate delivery of Solargis data” (Solargis homepage).
Our comparison pages show where a design platform ends and other tools begin. See SurgePV vs OpusFlow and SurgePV vs Solargis.
SurgePV covers roof modeling, layout, shading analysis, energy-yield modeling, financial modeling, electrical workflow support, bill-of-materials output and proposals in one workflow. That means fewer handoffs between those steps. In a guided demo, ask which exports fit the CRM and ERP you already use.
Which Solar Design Tools Publish an API?
The table lists what four vendors say on their own pages. Each cell says what the vendor pages in the Source column state. “Not stated” means those pages did not say.
| Tool | API | Plan or price for the API | Webhooks | Ready-made connectors | Source |
|---|---|---|---|---|---|
| OpenSolar | OpenSolar API | A paid add-on. API Access is billed as a per-project fee, priced by region, with a 30-day free trial | Yes, “Stream webhooks into internal systems” | OpenSolar-built connectors, such as Xero and QuickBooks accounting. Some are region-only | OpenSolar API page |
| Aurora Solar | Sync API and Design API. The pricing page marks the Design API as an add-on | “APIs and integrations” appear in the Enterprise plan, which has custom pricing | Yes: Expert Design Service completion, consumption profile updates, project status updates | “Partner apps” listed with the API features | Aurora API page, Aurora pricing |
| HelioScope | “Direct API access” | Enterprise plan, custom price per project | Not stated | The help centre lists integrations with SolarAnywhere, IronRidge, Nearmap, Energy Toolbase, HOMER Energy, PVBID and Unirac U-Builder | HelioScope pricing, HelioScope API article, Application Integrations |
| Pylon | API (plan table row “API Access”) | The Enterprise plan card lists “API support” | Yes. Events are sent to webhook destinations that you set in your API settings. The API reference marks events as “preview” | Includes Xero, ServiceM8, Mailchimp, Nearmap, Brighte, Smart Ease, Solaris Finance and Facebook Lead Ads. The page lists more | Pylon pricing, Pylon integrations, Pylon API reference |
OpenSolar’s page says its core platform stays free. The API and connectors are the paid parts, so count them in your budget. Aurora’s pricing page puts the API on its Enterprise plan. HelioScope is made by an Aurora company, and its pricing page also shows the API on Enterprise.
This table does not cover Zapier. Check each vendor’s own integration list before you plan a no-code flow.
How Does Data Flow Between Tools?
These example flows show the common patterns. They are illustrations, not claims that a given vendor supports each one. OpenSolar’s API page lists several of them, including “Auto-create OpenSolar projects from new leads” and “Push invoices and payments into accounting tools”.
CRM to design tool. A rep marks a lead as qualified. The CRM sends the name, address and power use to the design tool. The designer opens a project that is already filled in.
Design tool to CRM. The customer opens or accepts a proposal. The design tool tells the CRM. The deal moves to the next stage without a phone call.
Design tool to ERP. The designer finishes the system. The bill of materials goes to the ERP. The ERP checks stock and drafts purchase orders for a person to approve.
Monitoring to maintenance. An inverter reports a fault. The monitoring system opens a work order in the maintenance tool.
Accounting to CRM. A customer pays a deposit. The accounting tool tells the CRM. The project team sees the payment and books the install.
What Does a REST API Request Look Like?
REST is the most common style of web API. You send a request to a web address over HTTPS (the secure form of HTTP). The reply usually comes back as JSON, a plain-text format for structured data.
Enphase documents its public API as a REST API that delivers JSON over HTTPS. Its monitoring API can fetch system details, production, consumption and battery data (Enphase quick start). Each request carries an OAuth 2.0 access token and the application’s API key. A request to list systems looks like this:
GET /api/v4/systems?key=YOUR_API_KEY HTTP/1.1
Host: api.enphaseenergy.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Replace the two placeholders with the values from your own developer account. Never paste real keys into a blog, a chat or a public code repository.
Should You Use Webhooks, Polling or a Queue?
Choose by how fast the data must move.
- Polling. Your system asks for updates on a timer. It is simple and works with any API. The data can be late, and you may hit the vendor’s rate limit.
- Webhooks. The source system sends a message when something happens. It is fast, but your system needs a public address that can receive the message. A message can be lost if your system is down.
- Message queues. A broker such as RabbitMQ or Amazon SQS holds messages until your system is ready. It is reliable for high volume, but it adds more systems to run.
When data flows both ways, write down which system wins in a conflict. Common rules are system of record wins, most recent update wins, or a person decides. A system of record is the one tool that owns a given piece of data, such as the CRM owning the customer’s phone number.
Retries can send the same message twice. An idempotency key stops the second copy from creating a duplicate. Stripe’s API docs explain the idea: with an idempotency key you can “safely repeat the request without risk of creating a second object” (Stripe API reference). Ask whether the vendors you use support it.
Which Protocols Do Solar Devices Use?
Inverters, meters and chargers do not use web APIs. They use protocols. Each source below is the standards body or industry group for that protocol.
| Protocol | What its owner says it is | Source |
|---|---|---|
| Modbus | A communication protocol suite for automation devices, run by the Modbus Organization | Modbus Organization |
| SunSpec | The SunSpec Alliance publishes open standards for distributed energy and EV technologies, including SunSpec Modbus | SunSpec Alliance |
| MQTT | A lightweight publish/subscribe messaging standard for the Internet of Things | mqtt.org |
| DNP3 | An open, standards-based protocol for communication between substation computers, RTUs (remote terminal units), IEDs (intelligent electronic devices) and master stations in the electric utility industry. First adopted as IEEE Std. 1815 in 2010 | DNP Users Group |
| IEC 61850 | A standards series titled “Communication networks and systems for power utility automation” | IEC Webstore |
| OPC UA | Described by the OPC Foundation as “The Industrial Interoperability Standard” | OPC Foundation |
| OCPP | The open protocol between EV charging stations and charging management systems | Open Charge Alliance |
For EV charging, read our OCPP solar EV charging integration guide. Which protocol a device speaks is set in its datasheet, so check the datasheet before you plan the link.
How Do You Keep Solar Integrations Secure?
- Use OAuth 2.0 where the vendor offers it. OAuth 2.0 is described as the industry-standard protocol for authorization (oauth.net). The user approves access without sharing a password.
- Encrypt traffic with current TLS. NIST’s TLS guidance (SP 800-52 Rev. 2) requires US government servers and clients to support TLS 1.2, and requires TLS 1.3 support from January 1, 2024 (NIST SP 800-52 Rev. 2). Private firms can use it as a benchmark.
- Keep keys out of code. Store them in environment variables or a secrets manager. Use separate keys for testing and live data. Give each key only the access it needs.
- Check the common API risks. The OWASP API Security Top 10 (2023) lists risks such as broken authentication and unrestricted resource consumption (OWASP).
- Handle personal data with care. If you handle personal data covered by GDPR, a processor such as a software vendor must work under a contract or other legal act (GDPR, Article 28). Check the contracts you have with your software vendors.
- Keep an audit log. Record who connected what, which data moved, when, and whether it worked.
- Keep industrial protocols private. Do not expose Modbus or DNP3 devices to the public internet.
What Mistakes Break Integrations?
- No system of record. Two tools both edit the same field, and the data drifts apart.
- Dirty data. Automation spreads a typo in a CRM address to the design, the proposal and the permit.
- Too many links at once. Not every tool needs to talk to every other tool. Start with the most valuable link.
- Keys in code. Anyone who sees the code can use the key.
- No error handling. APIs fail and rate limits kick in. Retry with a wait between tries, and alert someone when a link is down.
- Syncing every field. Send only the fields each tool uses. Smaller syncs break less often.
- No map. Keep a one-page note of which tools connect, what moves each way, who wins a conflict, and who to call.
How Do You Pick an Approach?
Choose by the job, not by company size.
- One simple flow between two tools, such as lead to project. Use a built-in connector first. If there is none, use middleware.
- Several tools and custom rules. Use the vendors’ APIs and a developer. Add the API price to your budget. For example, OpenSolar bills API Access per project, and Aurora and HelioScope list the API on Enterprise plans.
- Many sites and field devices. Use a monitoring platform that already speaks the device protocols. Bring in a specialist for the rest.
Our solar software integration guide covers the planning steps in more detail. If you use Salesforce, read Salesforce for solar.
Conclusion
Integrations pay off when you build them one at a time. Take three steps this week:
- Map your handoffs. Draw the path from lead to commissioning. Mark every place where someone retypes data.
- Pick one link. CRM to design tool is a common first choice.
- Write it down. Note who owns each data type and how conflicts are settled.
SurgePV keeps solar design, shading, energy-yield and financial modeling, bill-of-materials output and solar proposals in one workflow. That cuts the handoffs inside design and sales. Book a Free Demo and ask which exports and integrations fit your stack.
Frequently Asked Questions
What APIs do solar companies usually connect?
They usually connect CRM, design, accounting, stock and monitoring tools. Examples are a CRM such as HubSpot or Salesforce, a design tool with an API such as OpenSolar or Aurora, accounting software such as QuickBooks or Xero, and monitoring APIs such as Enphase. The goal is to stop people retyping the same data between sales, design, buying, install and service.
What is the best way to connect solar design software to a CRM?
Use the simplest option that works. Start with a built-in connector. If there is none, use middleware such as Zapier for simple one-way flows, like a new lead creating a new project. For two-way sync or custom rules, use the vendors’ APIs with a developer, and choose which system owns each type of data.
What protocols do solar monitoring systems use?
Cloud services use REST APIs. Field devices use protocols such as Modbus, with SunSpec Modbus for distributed energy. Utility sites may use DNP3, IEC 61850 or OPC UA. MQTT is a lightweight messaging standard for IoT devices. EV chargers use OCPP. Check the device datasheet to see which one it speaks.
How do you keep data in sync between solar software tools?
There are three common methods. Polling asks for updates on a timer. Webhooks send a message when something changes. Message queues hold messages until the receiving system is ready. For two-way sync, decide which system wins a conflict, and use idempotency keys so a retry does not create a duplicate record.
What security standards should solar APIs follow?
Use OAuth 2.0 for access where the vendor offers it, and current TLS for traffic. NIST’s TLS guidance requires US government systems to support TLS 1.2, and TLS 1.3 from January 1, 2024. Keep keys out of code, review the OWASP API Security Top 10, and keep an audit log. If you handle personal data under GDPR, processors must work under a contract.
Can small solar installers afford API integrations?
Often yes, if they start small. Built-in connectors and middleware cost less than custom code. Check each vendor’s price first. OpenSolar says API Access is a paid per-project add-on. Aurora’s pricing page lists APIs and integrations on its Enterprise plan. HelioScope lists direct API access on its Enterprise plan.
What data should flow between a CRM and design software?
The CRM sends the customer name, site address, utility details, power use and the assigned rep. The design tool sends back the system size, production estimate, proposal link and proposal status. Decide which tool owns each field so the two never overwrite each other.
What mistakes break solar software integrations?
The common ones are no system of record, dirty data, too many links at once, keys stored in code, no error handling, syncing every field and no documentation. Start with one link, check the data, then add more.
Where this fits
This article is part of SurgePV's Solar Technology hub, which works through the topic from first principles to the decisions a project team actually has to make.


