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

# Integration Settings

> Configure organization-wide integration settings for Slack user imports and external calendar content.

Integration Settings allow administrators to control how Spock integrates with Slack and external calendar applications. These organization-wide settings determine user access permissions and what information is shared with external calendars.

<Note>
  This page is for administrators only. These settings affect your entire organization and require admin privileges to modify.
</Note>

## In this article

* [How to Access Integration Settings](#how-to-access-integration-settings)
* [Slack Users Import Settings](#slack-users-import-settings)
* [External Calendar Integration](#external-calendar-integration)
* [Saving Your Settings](#saving-your-settings)

## How to Access Integration Settings

<Steps>
  <Step title="Sign in to Spock Dashboard">
    Sign in to your Spock Dashboard with administrator credentials
  </Step>

  <Step title="Go to Settings">
    Navigate to **Settings** > **Integrations**
  </Step>

  <Step title="Configure Settings">
    Adjust integration settings according to your organization's needs
  </Step>

  <Step title="Save Changes">
    Click **Save Changes** to apply your settings
  </Step>
</Steps>

You can access Integration Settings directly at: [Open Integrations in Dashboard](https://spockoffice.com/spockapp/settings/integrations/)

<img src="https://mintcdn.com/ideoworks/d609JVqzMqN-nZjQ/images/spock-settings-integrations.png?fit=max&auto=format&n=d609JVqzMqN-nZjQ&q=85&s=0a85705d7a1f817b4e248544205ed97c" alt="Integration Settings" height="400" className="rounded-lg" data-path="images/spock-settings-integrations.png" />

## Slack Users Import Settings

### Control how imported Slack users access Spock

When you import users from Slack to Spock, you can control whether they can access the system immediately or require manual activation first. This setting helps you manage user onboarding and maintain control over workspace access.

**Setting:** Slack Users Import Settings

**Default:** Imported users can access Spock immediately

<Warning>
  **Important:** Guest users (Single or Multi Channel Guests) always require manual activation regardless of this setting. Activate them in Settings > Users.
</Warning>

### Configuration Options

You can choose between two options:

<AccordionGroup>
  <Accordion title="Imported users can access Spock immediately">
    When this option is selected:

    * Users imported from Slack are automatically activated in Spock
    * They can start using Spock right away without administrator intervention
    * They receive access to all features according to their role
    * No manual activation step is required

    **Use this option when:**

    * You want to streamline user onboarding
    * You trust all Slack workspace members to access Spock
    * You want to minimize administrative overhead
    * Your organization has a small to medium-sized team
  </Accordion>

  <Accordion title="Imported users require manual activation before accessing Spock">
    When this option is selected:

    * Users imported from Slack are created but remain inactive
    * They cannot access Spock until an administrator manually activates them
    * Administrators must activate each user individually in Settings > Users
    * This provides tighter control over workspace access

    **Use this option when:**

    * You want to control exactly who has access to Spock
    * You need to review user permissions before granting access
    * You have compliance or security requirements for user activation
    * You want to onboard users in phases or groups
  </Accordion>
</AccordionGroup>

### How to Select Import Behavior

<Steps>
  <Step title="Locate Setting">
    Find the **Slack Users Import Settings** section at the top of the Integrations page
  </Step>

  <Step title="Choose Option">
    Select one of the radio button options:

    * **Imported users can access Spock immediately** (recommended for most organizations)
    * **Imported users require manual activation before accessing Spock** (for controlled onboarding)
  </Step>

  <Step title="Save Changes">
    Click **Save Changes** at the bottom of the page to apply your selection
  </Step>
</Steps>

### Guest User Activation

Guest users in your Slack workspace are handled differently from regular members:

* Guest users are never automatically activated, even if you select "Imported users can access Spock immediately"
* Administrators must always manually activate guest users in the Users section
* This provides additional security control for external or limited-access users

To activate guest users:

1. Navigate to **Settings** > **Users**
2. Find the guest user in the user list
3. Click to activate their account
4. Configure their permissions and access level

<Tip>
  Guest users typically have limited access to your Slack workspace. By requiring manual activation, you can ensure these users receive appropriate permissions in Spock as well.
</Tip>

## External Calendar Integration

### Select what appears in external calendar

Control what information from Spock appears in external calendar applications when users subscribe to Spock calendars. This setting determines the types of events that are included in the iCal feed for Google Calendar, Apple Calendar, Microsoft Outlook, and other calendar applications.

**Setting:** External Calendar Integration

**Default:** All options enabled (all content types visible)

### Content Options

You can choose to include or exclude the following types of information in external calendars:

<AccordionGroup>
  <Accordion title="Show approved leave requests">
    **Checkbox:** Show approved leave requests

    When enabled:

    * All approved leave requests appear in external calendars
    * Users can see when team members are on leave
    * Leave events include relevant details like leave type and duration
    * Only approved requests are shown (pending or rejected requests are excluded)

    When disabled:

    * Leave requests are hidden from external calendars
    * Users must check the Spock Dashboard to see leave information
    * Calendar integration focuses only on other event types

    **Recommendation:** Keep this enabled. This is typically the primary reason for calendar integration and helps teams coordinate schedules.
  </Accordion>

  <Accordion title="Show public holidays">
    **Checkbox:** Show public holidays

    When enabled:

    * Public holidays configured in Spock appear in external calendars
    * Users can see official non-working days in their calendar app
    * Holiday events are clearly marked and visible across all platforms
    * Holidays reflect the holiday calendar assigned to each user

    When disabled:

    * Public holidays are hidden from external calendars
    * Users must reference other sources for holiday information
    * Calendar only shows leave requests and other selected event types

    **Recommendation:** Enable this to help users plan around official non-working days.
  </Accordion>

  <Accordion title="Show team member birthdays">
    **Checkbox:** Show team member birthdays

    When enabled:

    * Team member birthdays appear in external calendars
    * Users receive reminders about upcoming birthdays
    * Helps promote team culture and recognition
    * Birthday information must be added to user profiles in Spock

    When disabled:

    * Birthdays are hidden from external calendars
    * Users won't see birthday reminders in their calendar app
    * Birthday information remains private

    **Recommendation:** Enable this if your organization celebrates birthdays and wants to promote team engagement.
  </Accordion>

  <Accordion title="Show team member work anniversaries">
    **Checkbox:** Show team member work anniversaries

    When enabled:

    * Work anniversaries appear in external calendars
    * Users receive reminders about team members' milestone dates
    * Helps recognize employee tenure and loyalty
    * Anniversary dates must be configured in user profiles

    When disabled:

    * Work anniversaries are hidden from external calendars
    * Users won't see anniversary reminders in their calendar app
    * Anniversary information remains private

    **Recommendation:** Enable this to celebrate employee milestones and promote team recognition.
  </Accordion>
</AccordionGroup>

### How to Configure Calendar Content

<Steps>
  <Step title="Locate Setting">
    Find the **External Calendar Integration** section on the Integrations page
  </Step>

  <Step title="Review Options">
    Review the four checkbox options:

    * Show approved leave requests
    * Show public holidays
    * Show team member birthdays
    * Show team member work anniversaries
  </Step>

  <Step title="Select Content">
    Check or uncheck each option based on what you want to include in external calendars
  </Step>

  <Step title="Save Changes">
    Click **Save Changes** at the bottom of the page
  </Step>

  <Step title="Notify Users">
    After saving, inform users that they may need to re-subscribe to their calendars (see warning below)
  </Step>
</Steps>

### Re-subscription Requirement

<Warning>
  **Important:** To include holidays, birthdays, and anniversaries in external calendar app, all users will need to re-subscribe to their calendar. [Learn how to subscribe to calendar](/spock/integrations/calendar-integration)
</Warning>

When you change the external calendar integration settings:

* Users who have already subscribed to Spock calendars may not see the changes immediately
* Calendar applications cache iCal feeds and may not refresh automatically
* Users should unsubscribe and re-subscribe to their Spock calendars to see updated content

#### How Users Should Re-subscribe

Direct users to follow these steps:

<Steps>
  <Step title="Unsubscribe from Current Calendar">
    In their calendar application (Google Calendar, Apple Calendar, etc.), users should remove the existing Spock calendar subscription
  </Step>

  <Step title="Access Spock Dashboard">
    Users should sign in to the Spock Dashboard
  </Step>

  <Step title="Navigate to Calendar">
    Click the **Calendar** tab in Spock
  </Step>

  <Step title="Subscribe Again">
    Click **Subscribe Company Calendar** or **Subscribe Team Calendar** to add the calendar again with updated settings
  </Step>

  <Step title="Verify Content">
    Users should verify that the new content types (holidays, birthdays, anniversaries) now appear in their calendar
  </Step>
</Steps>

For detailed calendar integration instructions, refer to the [Calendar Integration Setup](/spock/integrations/calendar-integration) documentation.

<Tip>
  Plan calendar setting changes during a low-activity period and communicate with your team in advance. This gives users time to re-subscribe and minimizes disruption to their workflows.
</Tip>

## Saving Your Settings

After adjusting any integration settings, you must save your changes:

1. Review your selections for both Slack Users Import and External Calendar Integration
2. Click the blue **Save Changes** button at the bottom of the form
3. Alternatively, click **Cancel** to discard any changes and revert to previous settings

Changes to integration settings take effect immediately upon saving:

* Slack import behavior applies to all future user imports
* External calendar content changes require users to re-subscribe to their calendars

## Use Cases and Best Practices

### Recommended Settings for Most Organizations

For standard organizations:

* **Slack Users Import:** Imported users can access Spock immediately (streamlined onboarding)
* **External Calendar - Approved leave requests:** Enabled (essential for team coordination)
* **External Calendar - Public holidays:** Enabled (helps with planning)
* **External Calendar - Birthdays:** Enabled (promotes team culture)
* **External Calendar - Work anniversaries:** Enabled (celebrates milestones)

### Recommended Settings for Security-Conscious Organizations

For organizations with strict access controls:

* **Slack Users Import:** Imported users require manual activation (controlled access)
* **External Calendar - Approved leave requests:** Enabled (essential for team coordination)
* **External Calendar - Public holidays:** Enabled (helps with planning)
* **External Calendar - Birthdays:** Disabled if privacy is a concern
* **External Calendar - Work anniversaries:** Disabled if privacy is a concern

### When to Require Manual Activation

Choose manual activation for imported Slack users if:

* Your organization has compliance requirements for system access
* You want to verify user roles before granting access
* You're onboarding a large number of users and want to control the rollout
* You have a mix of full-time employees, contractors, and consultants with different access needs
* You need time to configure individual user permissions before they access Spock

### When to Show All Calendar Content

Enable all external calendar content options if:

* Your organization values team culture and recognition
* You want to maximize calendar integration benefits
* Privacy concerns about birthdays and anniversaries are minimal
* Your team actively uses external calendars for planning and coordination

### When to Limit Calendar Content

Disable some external calendar content options if:

* Your organization has privacy policies restricting personal information sharing
* You want to keep external calendars focused only on leave and holidays
* Your team doesn't celebrate birthdays or anniversaries organizationally
* You want to minimize calendar clutter

<Note>
  Integration settings are organization-wide and affect all users. Consider surveying your team or consulting with stakeholders before making significant changes.
</Note>

## Related Topics

<CardGroup cols={2}>
  <Card title="Calendar Integration Setup" href="/spock/integrations/calendar-integration">
    Learn how users can subscribe to Spock calendars in their calendar applications.
  </Card>

  <Card title="User Administration" href="/spock/team-management/user-administration">
    Manage user accounts and manually activate imported Slack users.
  </Card>

  <Card title="Birthdays & Anniversaries" href="/spock/integrations/birthdays-anniversaries">
    Configure birthday and work anniversary tracking for your organization.
  </Card>

  <Card title="Holidays" href="/spock/leave-management/holidays">
    Set up public holiday calendars that appear in external calendar apps.
  </Card>
</CardGroup>

<Tip>
  After changing integration settings, communicate the changes to your team. For external calendar changes, provide clear instructions on how to re-subscribe and include a timeline for when they should complete the re-subscription.
</Tip>