Integration setup

LinearFree tier OK

Push your roadmap items into Linear as issues. The webhook syncs status changes back automatically (Linear "Done" → Supoid roadmap "Completed"). The AI agent can create issues, add comments, and flip state on your behalf — opt in per tool in Settings → AI Agent.

Create the Linear OAuth app

1. Open linear.app/settings/api/applications → New OAuth Application
2. Fill in:
   • Application Name: Supoid
   • Description: AI customer feedback + roadmap sync
   • Callback URLs: https://supoid.com/api/integrations/linear/callback
   • Webhook URL: https://supoid.com/api/integrations/linear/webhook
   • Webhook events: Issues + Comments + OAuth Authorization
3. Save → copy Client ID + Client Secret + Webhook signing secret.

Connect from Supoid

1. Open /settings/integrations/linear in your workspace
2. Click Connect with Linear
3. Pick the team you want feedback to push into
4. Test: open a roadmap item → "Push to Linear" → Linear issue created

HubSpotFree tier OK

Push shipped feedback as HubSpot tickets. The AI agent can update stages + add notes. Contacts are auto-associated by email when the feedback came from an identified user.

Create the HubSpot Public App

1. Open developers.hubspot.com/apps → Create app → Public app (NOT MCP app)
2. App info → Name: Supoid
3. Auth tab:
   • Redirect URL: https://supoid.com/api/integrations/hubspot/callback
   • Scopes: tickets, crm.objects.contacts.read, crm.objects.contacts.write, oauth
4. Save → Auth tab now shows Client ID + Client Secret. Copy both.

Connect from Supoid

1. Open /settings/integrations/hubspot
2. Click Connect HubSpot
3. Pick the HubSpot account → grant permissions
4. Done — open any feedback in your inbox, change status to Completed, ticket appears in HubSpot.

SlackFree tier OK

The Slack OAuth bot posts new feedback + shipped changelog to a channel of your choice. One workspace install covers every channel — no per-channel webhook URL setup.

Create the Slack app

1. Open api.slack.com/apps → Create New App → From scratch
2. Name: Supoid, pick a workspace for testing
3. OAuth & Permissions sidebar:
   • Redirect URL: https://supoid.com/api/integrations/slack/oauth/callback
   • Bot Token Scopes: chat:write, chat:write.public, channels:read, team:read
4. Basic Information sidebar — copy Client ID + Client Secret
5. Manage Distribution sidebar → Activate Public Distribution (so your customers can install it too)

Connect from Supoid

1. Open /settings/integrations/slack
2. Click the new Install Slack App button in the upper blue panel
3. Pick a default channel for new feedback
4. Test: hit the "Test" button → check your channel

Bot mode coexists with the legacy webhook integration. If you set both, bot mode wins.

SalesforceDeveloper Edition free

When feedback ships, push as a Salesforce Case. The AI agent can update case status + add public comments. Refresh-token rotation is handled automatically.

For testing, sign up for Developer Edition — forever free, 2 users, full API.

Create the Connected App

1. In Salesforce, click ⚙️ → Setup
2. Quick Find: App Manager → New Connected App → Create a Connected App
3. Basic info:
   • Connected App Name: Supoid
   • Contact Email: your email
4. ☑ Enable OAuth Settings:
   • Callback URL: https://supoid.com/api/integrations/salesforce/callback
   • Scopes: Manage user data via APIs (api) + Perform requests at any time (refresh_token, offline_access)
5. Save → wait 10 minutes (Salesforce is async)
6. App Manager → click app → View → Manage Consumer Details → email/SMS verification → copy Consumer Key (= Client ID) + Consumer Secret (= Client Secret)

Connect from Supoid

1. Open /settings/integrations/salesforce
2. Click Connect Salesforce
3. Login flow uses login.salesforce.com regardless of instance — DE works exactly like prod.

IntercomPaid (14-day trial)

When a feedback shipped from an Intercom conversation, Supoid posts a "We shipped this" reply on the originating conversation. Bonus: Autopilot discovery — every 6 hours, AI scans recently-closed Intercom conversations and extracts product feedback into your review queue.

Create the Intercom OAuth app

1. Open developers.intercom.com → Your apps → New app
2. OAuth, Authentication & Authorization page:
   • Redirect URL: https://supoid.com/api/integrations/intercom/callback
3. Basic Information page → copy Client ID + Client Secret

Connect from Supoid

1. Open /settings/integrations/intercom
2. Click Connect Intercom
3. Once connected, toggle Autopilot discovery on the same page if you want AI to surface feedback from your support conversations.

Troubleshooting

"redirect_uri_mismatch"

The redirect URL in your OAuth app doesn't exactly match the one Supoid sends. Most common: trailing slash. The callback URL must end at /callback with no trailing slash.

"Setup needed" amber banner won't go away

Workspace owner adds CLIENT_ID + CLIENT_SECRET to .env.local + Vercel project env vars + redeploy. Self-hosted? Same env vars in your container.

OAuth flow returns "exchange_failed"

Check the callback URL is reachable from the public internet (not localhost). Provider's auth server has to POST your token endpoint.

Need help?

Email hello@supoid.com with your provider name + the error message you see — usual response time under a day.