"Connection failed" when adding a source
Read the code the add-source wizard shows when a connection test is rejected, correct the field it names, and run the check again.
Adduce tests your credentials before it creates the source, so a rejected test creates nothing and retrying costs nothing.
What this means
The check did not pass, and the result screen says why. Its last line is a code naming one of the four below.
| Code | What happened | Where to look |
|---|---|---|
auth_failed | The tool refused the key, token or password | Issue a fresh credential and paste the whole thing |
not_found | The credential works, but the project, property or account it names is not visible to it | The id field, and the credential's own scope |
network | Adduce could not reach the tool, or your browser could not reach Adduce | The region or host field, then try again in a few minutes |
invalid_config | A field is the wrong shape — a host that is not a public https URL, a region outside the list, a required field left empty | The field named beside the code |
Anything else is an error Adduce could not place: the tool's own words, or ours if the create failed after a passing check.
PostHog's check never leaves Adduce: it tests that the API host is a public https URL and the project API key begins phc_, and does not contact PostHog. A PostHog source can pass this step and still bring nothing back on its first sync.
Fix
Read the message under Couldn't connect. When the tool answered, these are its own words, and the fastest route to the cause.
Read the code line under it. It carries one of the codes above and, where Adduce can name a single field, that field.
Choose Edit details. Everything you typed comes back with you. The field in the code line is not marked for you, so correct it from what you read there.
Choose Continue to run the check again, or Try again to repeat it unchanged. A rejected check is never remembered, so every retry is a fresh attempt. The Connect page for your tool names the scope it needs.
If it persists
Send the code line and the message to hello@adducehq.com, with the tool you were connecting. Neither carries your credential.