> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Setup Examples

> Step-by-step setup guides for common integrations

Get started quickly with these step-by-step guides for the most popular integrations.

## Quick Setup Examples

<AccordionGroup>
  <Accordion title="Google Workspace (OAuth)" icon="mail">
    <Steps>
      <Step title="Connect">
        Settings → Integrations → Google Workspace → Connect
      </Step>

      <Step title="Sign In">
        Select Google account
      </Step>

      <Step title="Approve">
        Review and click Allow
      </Step>

      <Step title="Done">
        Integration shows as Connected
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Slack (OAuth)" icon="slack">
    <Steps>
      <Step title="Connect">
        Settings → Integrations → Slack → Connect
      </Step>

      <Step title="Select Workspace">
        Choose Slack workspace
      </Step>

      <Step title="Approve">
        Review permissions and click Allow
      </Step>

      <Step title="Invite Bot">
        Use `/invite @Noxus` in channels you want to use
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Airtable (API Key)" icon="table">
    <Steps>
      <Step title="Generate Key">
        Go to airtable.com/account → Generate API key
      </Step>

      <Step title="Copy Key">
        Copy the key (starts with `key...`)
      </Step>

      <Step title="Add to Noxus">
        Settings → Integrations → Airtable → Paste key
      </Step>

      <Step title="Save">
        Click Connect
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Microsoft 365 (Service Principal)" icon="building">
    <Steps>
      <Step title="Azure Setup">
        Register app in Azure Portal with required permissions
      </Step>

      <Step title="Admin Consent">
        Grant admin consent for organization
      </Step>

      <Step title="Generate Secret">
        Create client secret in Azure
      </Step>

      <Step title="Configure Noxus">
        Enter Tenant ID, Client ID, and Client Secret
      </Step>
    </Steps>

    <Card title="Detailed Guide" icon="book" href="/integrations/providers/microsoft">
      Complete Microsoft 365 setup guide
    </Card>
  </Accordion>

  <Accordion title="Salesforce (Client ID / Access Token)" icon="cloud">
    <Steps>
      <Step title="Create Connected App">
        In Salesforce: Setup → Apps → App Manager → New Connected App. Enable OAuth Settings and select the scopes you need.
      </Step>

      <Step title="Generate Access Token">
        From the Connected App, generate an access token (or use an existing one issued for your org).
      </Step>

      <Step title="Add to Noxus">
        Settings → Integrations → Salesforce → enter Instance URL (e.g. `https://yourcompany.my.salesforce.com`) and Access Token.
      </Step>

      <Step title="Save">
        Click Connect. Noxus validates the token against `/services/oauth2/userinfo`.
      </Step>
    </Steps>

    <Card title="Detailed Guide" icon="book" href="/integrations/crm/salesforce">
      Full Salesforce setup guide
    </Card>
  </Accordion>

  <Accordion title="SAP (Client ID / Access Token)" icon="building">
    <Steps>
      <Step title="Create OAuth2 Client App">
        In your SAP system (e.g. SuccessFactors Admin Center → API Center, or Gateway Service Builder for OData), create an OAuth2 Client Application and grant the required permissions.
      </Step>

      <Step title="Collect Credentials">
        Note the Base URL, Client ID, Client Secret, and Company ID (SuccessFactors only).
      </Step>

      <Step title="Add to Noxus">
        Settings → Integrations → SAP → select product (S/4HANA, SuccessFactors, Ariba, Concur) and paste the credentials.
      </Step>

      <Step title="Save">
        Click Connect and run a test query to verify connectivity.
      </Step>
    </Steps>

    <Card title="Detailed Guide" icon="book" href="/integrations/erp/sap">
      Full SAP setup guide
    </Card>
  </Accordion>
</AccordionGroup>

***

## Common Providers

Detailed guides for popular integrations:

<CardGroup cols={2}>
  <Card title="Microsoft 365" icon="building" href="/integrations/providers/microsoft">
    OAuth and Service Principal for Outlook, Teams, SharePoint, and Dynamics 365
  </Card>

  <Card title="Google Workspace" icon="mail" href="/integrations/providers/google">
    OAuth for Gmail, Drive, Sheets, Docs, and Calendar
  </Card>

  <Card title="Atlassian" icon="trello" href="/integrations/providers/atlassian">
    API token for Jira and Confluence
  </Card>

  <Card title="Developer Tools" icon="code" href="/integrations/providers/developer-tools">
    GitHub, Linear, GitLab integration guides
  </Card>

  <Card title="Collaboration" icon="message-circle" href="/integrations/providers/collaboration">
    Slack, Notion, Discord, and Telegram
  </Card>

  <Card title="All Integrations" icon="blocks" href="/integrations/catalog">
    Complete catalog with all 30+ integrations
  </Card>
</CardGroup>