Skip to main content

Connect WordPress

Connect your WordPress site to Impossible by entering your API key in the settings. The plugin connects to the Impossible API automatically.

Prerequisites

Configure settings

1

Open settings

In WordPress admin, go to Impossible → Settings.
2

Enter API key

Paste your API key in the API Key field. The key is stored securely and displayed masked after saving.
3

Local development (optional)

If you’re using LocalWP or a local site behind ngrok, check Are you using this on a local / development environment? and paste your tunnel URL (e.g. from ngrok) so the orchestrator can reach your site.
4

Test connection

Click Test Connection. Wait for “Connection successful.” This validates your key and registers your site.
5

Save

Click Save if you made changes. The builder will not work until Test Connection succeeds.
Success: When Test Connection succeeds, the plugin stores a site secret used for secure requests. You can now open the builder.

Settings reference

FieldDescription
API KeyFrom the Impossible web app (Dashboard → API Keys). Stored masked; paste the full key when saving.
Local / developmentToggle to show Site URL Override. Use when running locally with ngrok so the orchestrator can reach your site.
Site URL OverrideYour ngrok or tunnel URL. Only visible when “Local / development” is checked.
Test ConnectionValidates the API key and registers this site. Required before using the builder.

Environment-specific setup

For production:
  • Enter only your API key. The plugin connects to the Impossible API automatically.
  • Do not set WPA_DEV_MODE — use Test Connection for proper authentication
  • Ensure your WordPress site has a public HTTPS URL
Keep your API key private. Never commit it to version control or expose it in public code.