Skip to content

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

FieldMeaning
Website nameFriendly label shown in the website dashboard.
Site URLThe public base URL for the connected site. Use the site host, not a resource path.
Connection IDThe unique connection identifier supplied by support.
One-time setup codeTemporary 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:

  1. Open the site card in website.tropikal.ai.
  2. Ask “What resources can I manage here?”
  3. Ask for a read-only list from one resource.
  4. Test a small draft or update only after the read path works.

Rotate a token

If a one-time setup code is rotated:

  1. Open the site connection in the website dashboard.
  2. Edit the manual setup fields.
  3. Paste the new one-time setup code.
  4. Save and test again.

The old code should stop working after rotation.

Troubleshooting

SymptomFirst check
Malformed API URLUse the public base URL and remove extra resource paths.
Setup code rejectedConfirm the code was copied once, not previously rotated, and belongs to the same connection.
Resource missingConfirm the expected resource was approved for this site connection.
Action deniedGrant the specific permission rather than broadening every resource.