I-Doit integration error - undefined method `[]' for nil:NilClass

Infos:

  • Used Zammad version: 6.5.2
  • Used Zammad installation type: docker-compose
  • I-Doit on-prem with API addon v 2.4

The addon config seems not to be located where the zammad documentation is pointing to.
It has moved to Admininstration>Add-ons>JSON-RPC API

There we can see the API-Key (Documentation is talking about API Token)

We have configured the zammad i-doit integration with the URL and the api-key and when applying settings (save button) we receive a window with following error

undefined method `[]' for nil:NilClass

When leaving the settings and checking again the values for url, api-key etc. have vanished.

In docker logs we get

zammad-railsserver-1    | E, [2025-11-24T11:02:00.453776#1-197540] ERROR -- : undefined method `[]' for nil:NilClass (NoMethodError)
zammad-railsserver-1    | lib/idoit.rb:127:in `_query'
zammad-railsserver-1    | lib/idoit.rb:24:in `verify'
zammad-railsserver-1    | app/controllers/integration/idoit_controller.rb:7:in `verify'
zammad-railsserver-1    | app/controllers/application_controller/handles_transitions.rb:16:in `handle_transaction'

Has anyone else had the same problem?
What does this error mean, how to debug?

Hi @zammad_user13.

This line points to using invalid credentials to login.

I don’t understand why. I copy/paste the api key, even manually typed the password.
Used only digits/chars no special chars.
I even set I-Doit Api “Enforce authentification” to “No”.

Can’t get it right. Any hint what/where to look for?

Unfortunately, I am not familiar with i-doit. If the credentials are fine, it seems there is no proper response from their API, but I don’t know the reason.

Check your i-doit admin center > system settings > expert > api.authenticated-users-only, it should be set to 0.

But i had more issues with this specific settings that did not work correctly, i solved it for me here: Nutzung i-doit API mit API Key nicht möglich | i-doit Community