--- title: "Start installing an app" canonical: "https://admiral.io/docs/api/integrations/IntegrationAPI_InstallIntegration" --- # Start installing an app `POST https://api.admiral.io/v1/integrations/install` For KIND_GITHUB the person must be an owner of the GitHub organization, since GitHub lets only an owner install an app that asks for organization permissions. Scope: `integration:write` ### Request body - `kind` (Kind, required): enum.defined_only = true One of `KIND_GITHUB`. ### Response 200 Success - `url` (string): Where to send the browser: the vendor's install page with the signed state already in its query.