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 |
- Accept the service terms.
- Enter the key and enable the integration.
- Click Save.
- 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.
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.
