Events API Overview

The Events API in Slotify provides the tools necessary to manage calendar events within your scheduling system. Unlike bookings, which represent scheduled appointments or reservations, calendar events serve as broader time blocks or occurrences on your calendar.

These can include non-bookable entries such as holidays, meetings, personal time blocks, or any other type of event that needs to be reflected in your calendar. The Events API allows you to create, retrieve, update, and delete these events, helping to maintain an accurate and organized calendar.

Key Features of the Events API

  • Calendar Event Management: Create and manage calendar events that block time on your calendar without being associated with customer bookings. This includes events like internal meetings, personal appointments, or company-wide holidays.
  • Non-Bookable Time Blocks: Define non-bookable events to mark times when resources are unavailable, which prevents conflicts with bookings and ensures accurate availability.
  • Integration with External Calendars: Sync calendar events with external calendars (e.g., Google Calendar, Microsoft Outlook) to maintain consistency across all platforms and streamline scheduling.
  • Custom Event Details: Include detailed information for each event, such as event names, descriptions, locations (virtual or physical), and time zones to ensure clear communication of event purposes and logistics.
  • Resource Association: Attach specific resources (e.g., rooms, equipment) to calendar events to manage resource allocation and prevent double-booking or conflicts with regular scheduling operations.

Common Use Cases

  • Blocking Off Personal Time: Use the API to block off time for personal appointments or breaks to ensure this time is unavailable for customer bookings.
  • Company Holidays: Add company-wide holidays or non-working days to the calendar to automatically prevent bookings during these times.
  • Internal Meetings: Schedule internal meetings or administrative time on the calendar without affecting customer-facing availability.
  • Resource Reservations: Reserve resources for internal use (e.g., reserving a conference room for a team meeting) to ensure availability is accurately reflected across all scheduling operations.

Authentication

Before using the Slotify API to manage workflow, you must authenticate your requests using Member tokens. You can obtain an Member token by signing up for a Slotify account and going to navigate to resources page.

All requests to the Slotify API must include an Authorization header with the value "Bearer <MemberToken>". App token must be base 64 encoded.

Member Token: The member token is a base64-encoded string containing the user's email and personal token.

Rate Limits

The Events API is subject to rate limits to ensure fair usage and optimal performance. Please refer to the rate limiting section of the pricing tier for more details on managing your API usage effectively.

Next Steps