SurgePV Luminous Solar PartnersAV
Settings › Integrations › Webhooks

Webhook: M-Partner

SurgePV calls this URL when a project that came from M-Partner changes. Nothing else is sent.

Active
1. API keyM-Partner production ·•••9f2c
2. Field mapping7 fields, 5 defaults
3. Webhook2 events
4. Test leadSend one from M-Partner staging
HTTPS only. Must answer 2xx within 10 s.
Events
✓
proposal.ready
Proposal generated. System size plus a 30-day share link.
✓
project.status_changed
Customer Inquiry → Engineering Design → Proposal Shared …
Only projects created by key M-Partner productionLocked
Your own walk-in projects are never sent to M-Partner.
whsec_••••••••••••••••3b1d
Every call carries X-SurgePV-Signature: HMAC-SHA256 of timestamp + body. Rotate only after M-Partner is ready.
Retries after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h. Then failed; Admins get an email.

Send a test event

200 OK from M-Partner in 236 ms · 22 Oct 11:15{"received": true}
Sample payload sent (marked "test": true, no real project)
POST https://mpartner.luminous.example/hooks/surgepv
X-SurgePV-Event: proposal.ready
X-SurgePV-Delivery: dlv_test_3Zr8
X-SurgePV-Signature: t=1792647912,v1=9c41…e2b7

{
  "id": "evt_test_3Zr8",
  "type": "proposal.ready",
  "test": true,
  "created_at": "2026-10-22T11:15:12+05:30",
  "data": {
    "project_id": "prj_test_0001",
    "external_id": "MP-TEST-0001",
    "status": "proposal_shared",
    "system_kwp": 4.64,
    "proposal_url": "https://app.surgepv.com/share/p/…",
    "proposal_url_expires_at": "2026-11-21T11:15:12+05:30"
  }
}
Demo data