"Unknown Error Occurred" when adding a HA integration

[ScoobySnacks79]

Total noob, so apologies for my lack of the technical language.

I'm setting up HA to allow me to control items in the house depending on Octopus settings on my Zappi.

I've registered for the AlphaESS API and obtained an ID and key, but when I enter them in to the integration through HACS it comes up with the above error.

Any ideas where I went wrong or how to resolve the issue?

[Poshy163]

Hi @ScoobySnacks79,

What is shown in the home assistant logs in relation to the integration when you submit the information?

[ScoobySnacks79]

Apologies, forgot to attach the log text. Thanks for the quick reply.

"This error originated from a custom integration.

Logger: alphaess.alphaess
Source: custom_components/alphaess/config_flow.py:32
integration: alphaess (documentation, issues)
First occurred: January 9, 2026 at 10:47:26 PM (4 occurrences)
Last logged: January 9, 2026 at 10:53:13 PM

Unexpected json_response : {'code': 6007, 'msg': 'Sign check error'} when calling https://openapi.alphaess.com/api/getEssList
'NoneType' object is not iterable"

[SimAWright]

Hello!

Experiencing the same:

Logger: alphaess.alphaess
Source: custom_components/alphaess/config_flow.py:32
integration: alphaess (documentation, issues)
First occurred: 22:41:12 (10 occurrences)
Last logged: 22:45:28

Unexpected json_response : {'code': 6007, 'msg': 'Sign check error'} when calling https://openapi.alphaess.com/api/getEssList
'NoneType' object is not iterable

Appreciate your efforts with this.

[Poshy163]

Unfortunately, I believe this is an issue on alphas end, I'll keep this issue open but most likely you'll have to contact them and see if they can resolve it.

I have seen some users on Facebook groups have some luck with resolving it via restarting their inverters, tho I would contact alpha first before taking that route

[ScoobySnacks79]

Thanks. What would I need to ask them to do? Just tell them that the API isn't working properly?

[SimAWright]

I've tested this using another platform a retired a while back, brought it back just to try it, and followed up with Postman - response from the API is:

{
"code": 6007,
"msg": "Sign check error"
}

Feels like authentication is broken. Tried to reset my password to open a support ticket and its not accepting my login, so cant seem to even raise the issue!

[PJiricek]

I had the same error: "code": 6007, "msg": "Sign check error".
Uninstalling the integration didn’t help; after reinstalling, the device cannot be added.
I submitted a support request, and the reply was:
“We have conducted targeted tests on the interface https://openapi.alphaess.com/api/getEssList on our end, and the scheduling and response of the interface are functioning normally. At this stage, we suspect that the issue may be caused by an improper encryption process of your sign parameter.”
The integration is still not working, but now the error is: {'code': 6009, 'msg': 'The request timestamp is not within the validity period'}.

[ScoobySnacks79]

I had the same error: "code": 6007, "msg": "Sign check error". Uninstalling the integration didn’t help; after reinstalling, the device cannot be added. I submitted a support request, and the reply was: “We have conducted targeted tests on the interface https://openapi.alphaess.com/api/getEssList on our end, and the scheduling and response of the interface are functioning normally. At this stage, we suspect that the issue may be caused by an improper encryption process of your sign parameter.” The integration is still not working, but now the error is: {'code': 6009, 'msg': 'The request timestamp is not within the validity period'}.

Thanks.

Out of interest, how did you get through to them to put in a ticket? I've tried to log in using the username and password I used for setting up the developer account but it's not working.

Cheers

Matt

[PJiricek]

Stejnou chybu jsem měl: "kód": 6007, "msg": "Chyba kontroly podpisu". Odinstalování integrace nepomohlo; po přeinstalaci nelze zařízení přidat. Podal jsem žádost o podporu a odpověď zněla: „Provedli jsme cílené testy na rozhraní https://openapi.alphaess.com/api/getEsSList na našem konci a plánování a reakce rozhraní fungují normálně. V této fázi máme podezření, že problém může být způsoben nesprávným šifrovacím procesem vašeho parametru znamení.“ Integrace stále nefunguje, ale nyní je chyba: {'code': 6009, 'msg': 'Časové razítko požadavku není v době platnosti'}.

Díky.

Ze zájmu, jak jste se k nim dostal, abyste si dal lístek? Snažil jsem se přihlásit pomocí uživatelského jména a hesla, které jsem použil pro nastavení účtu vývojáře, ale nefunguje to.

Na zdraví

Matta

“When requesting support, I used the website https://cloud.alphaess.com/..
I also have an update: I reported error 6009 to support again. They replied once more that they couldn’t find any issue, but it is now working for me.”

[SimAWright]

Ah the classic, “we can’t see an issue” and it suddenly starts working again.

Can confirm- working for me now too.