Integrations
An integration is a connection to an outside service. There are two kinds, they live on different screens, and mixing them up is the single most common source of "I configured it and my colleague cannot see it".
The distinction
| Company integration | Personal integration | |
|---|---|---|
| Configured by | An owner or admin | You |
| Used by | Everyone in the organization | You |
| Lives on | Company settings → Integrations | Account → My integrations |
| Survives you leaving | Yes | No — it follows your account |
A company integration is configured once, for everyone. If you want the whole organization to be able to run agents, that is where the credential goes.
A personal integration is yours. It follows your account, and where both exist, yours is used first for things you do. → Personal vs shared
Neither kind ever returns a stored secret value back to anyone, including you.
Git providers
A Git connection authorizes PlatformSmith and your agents to reach your repositories. It is an organization-level integration, assigned to the workspaces allowed to use it.
Full walkthrough: Connect GitHub.
A Git connection and a GitHub sign-in identity are unrelated things that name the same provider:
- Signing in with GitHub proves who you are to PlatformSmith. It is on your account.
- A Git connection lets agents clone and push. It is on the organization.
Having one does not give you the other, and removing one does not affect the other.
AI provider credentials
Two different things use a model credential, and they resolve separately:
- Coding agents in your containers — see Credentials and secrets.
- Forgemate, the in-app assistant — resolved per request from your organization's AI credential.
An organization can configure one credential that serves both, and usually does. If Forgemate reports no credential, an admin connects one under Company settings → Integrations, or you add a personal key under Account → My integrations.
Webhooks
Integrations that react to events elsewhere need a webhook pointing back at PlatformSmith. Where automatic registration is supported, connecting the integration sets the webhook up for you; where it is not, you create the hook by hand in the other service using the URL PlatformSmith shows you.
Adding an integration
Company settings → Integrations (organization-wide) or Account → My integrations (yours). Pick the provider, pick the authentication method it offers, and supply the credential. Which methods are available depends on the provider — a subscription-based method can only ever be personal.