Open the directory

Open System → Integrations → Directory (search.ch) with system rights. Prepare a service key. Wait for the settings to load; if it fails, use Retry.

Configure the service

Field Purpose Possible values Example
Terms acceptance Authorizes use according to the service terms Toggle Enabled after reading
Activation Allows searching the directory Toggle available after acceptance Enabled
API Key Authenticates the installation Service secret; leaving it empty keeps the saved key Key provided by the service
  1. Accept the service terms.
  2. Enter the key and enable the integration.
  3. Click Save.
  4. Check the result displayed.

Cancel discards the draft. Withdrawing acceptance also disables activation in the form. Explicitly clearing a saved key takes effect immediately: it is not undone by canceling the draft.

Finding webhook logging

Temporary logging is found under System → Queues and webhooks. An older integrations address may offer two buttons: one for the directory, the other for this logging. See Queues and webhooks.

Integrations page in the new system menu, in light mode; sample data, secrets, and personal information hidden.

Check the result

Review the status after saving. Verify that a search is authorized using test data.

If it doesn’t work

Activation requires a key and acceptance of the terms. Check these two items and the diagnostic displayed. An access denial requires checking the account’s rights.