Manual Setup
Manual setup is the support-assisted website connection path. Use it only when you already have connection details from Tropikal support or you are migrating an existing connection.
For most new sites, start with Website quickstart instead.
When to use manual setup
Use manual setup when:
- You are migrating an existing website connection.
- You need to reconnect after a one-time setup code is rotated.
- A support engineer explicitly asks you to test connection details.
Do not use manual setup as the default first-run path unless support asks you to.
Fields
| Field | Meaning |
|---|---|
| Website name | Friendly label shown in the website dashboard. |
| Site URL | The public base URL for the connected site. Use the site host, not a resource path. |
| Connection ID | The unique connection identifier supplied by support. |
| One-time setup code | Temporary setup credential supplied by support. Treat it like a password and rotate it if exposed. |
Save and test
When you save, Tropikal immediately tests the connection. A successful test means Tropikal can reach the site connection and read the list of approved resources. It does not mean every write action is enabled.
After a successful save:
- Open the site card in
website.tropikal.ai. - Ask “What resources can I manage here?”
- Ask for a read-only list from one resource.
- Test a small draft or update only after the read path works.
Rotate a token
If a one-time setup code is rotated:
- Open the site connection in the website dashboard.
- Edit the manual setup fields.
- Paste the new one-time setup code.
- Save and test again.
The old code should stop working after rotation.
Troubleshooting
| Symptom | First check |
|---|---|
| Malformed API URL | Use the public base URL and remove extra resource paths. |
| Setup code rejected | Confirm the code was copied once, not previously rotated, and belongs to the same connection. |
| Resource missing | Confirm the expected resource was approved for this site connection. |
| Action denied | Grant the specific permission rather than broadening every resource. |