Reference

Get Assistant Message

Retrieve automated responses and messages from your CalendarHero assistant to see what replies have been sent to clients or team members.

Send Assistant Message

Send natural language messages to the CalendarHero assistant to automate scheduling, manage calendar events, and handle calendar-related tasks through conversational commands.

Add Calendar Connection

Create a new calendar connection to organize and manage different types of meetings within CalendarHero. This helps you separate and configure distinct meeting categories (like sales calls, consultations, or team meetings) for better scheduling control.

List User Calendars

Retrieves all calendars connected to your CalendarHero account so you can see which calendars are available for scheduling and management. Helpful for understanding your complete calendar ecosystem before organizing events or delegating scheduling tasks.

Create Contact

Add a new contact to your CalendarHero system with their details so you can easily manage and schedule with them. This enables you to build a centralized database of people you work with regularly.

Search Contact

Find existing contacts in your calendar system by searching with their email address or name, helping you quickly locate and manage client or team member information.

Update Contact

Modify existing contact information in CalendarHero such as name, email, phone number, job title, or organization. This keeps your contact database current and ensures you're reaching people at their correct contact details.

Delete Contact

Permanently removes a contact from your CalendarHero system by their unique identifier. Use this when you no longer need to interact with or schedule meetings with a specific person.

Fetch Contact

Retrieve detailed information about a specific contact stored in CalendarHero, including their name, email, phone, and other communication details to keep your client database current and accessible.

Get Contact Count

Retrieves the total number of contacts stored in your CalendarHero account, helping you understand your contact database size at a glance.

Delete User Directory

Remove a directory from your CalendarHero account when you no longer need it or want to clean up outdated calendar organization structures.

Get User Directory

Retrieve detailed configuration and settings for a specific calendar directory, including all associated meeting types and tracking preferences. Use this to access and verify how your calendar scheduling system is set up.

List User Directories

Retrieve all directories that have been set up for your account to see which scheduling sources and configurations are available.

Update User Directory

Modify your CalendarHero directory settings to keep your scheduling information current, such as updating your professional title, available meeting types, or booking configurations.

Search Integrations

Find specific events, meetings, or calendar data across all your connected integrations by searching for keyword matches. This helps you quickly locate relevant information scattered across multiple calendars and productivity tools without manually checking each one.

Create Meeting Request V2

Create a new meeting request in CalendarHero by specifying participants, preferred time ranges, and meeting details to streamline your scheduling process. This eliminates back-and-forth emails and lets participants pick times that work for them.

Delete Meeting Task

Removes a meeting task or request from CalendarHero, allowing you to clean up scheduling records and eliminate outdated meeting preparations from your calendar system.

Get Meeting Tasks

Retrieve your pending meeting requests and scheduling tasks from CalendarHero to stay on top of coordination activities and meeting confirmations. Filter by status to focus on active, upcoming, or completed meetings.

List Meeting Templates

Retrieves all pre-configured meeting templates with saved settings like duration, availability windows, and video conferencing preferences. Use this to see what meeting types are available before scheduling or to quickly access your most-used meeting configurations.

List Meeting Types

Retrieve all meeting types you've configured in CalendarHero, including their availability windows, durations, and booking URLs. This helps you understand and manage the different meeting options available to your clients and prospects.

Delete Meeting Type

Remove a meeting type from your CalendarHero account when you no longer need it for scheduling. This helps keep your meeting options current and prevents clients from booking outdated meeting formats.

Update Meeting Types

Modify existing meeting type settings such as availability windows, duration, notice periods, and booking rules for your CalendarHero profile.

Fetch Meeting Details

Retrieve detailed information about meetings scheduled within a specific time period, including attendees, topics, and timing details. This helps you quickly access meeting data without manually reviewing your calendar.

Get Meeting Categories

Retrieves statistics about your meeting categories over a specified time period, helping you understand how your time is distributed across different types of meetings.

Get User Organization

Retrieves your organization's details and settings from CalendarHero, giving you access to key information about your workspace configuration and membership.

Send Reminder

Sends an email reminder to meeting attendees about an upcoming scheduled meeting, ensuring no one misses important appointments.

Get Search Result

Retrieves detailed information about a specific search result using its ID from a previous search query. This is useful for accessing cached search data without repeating the search.

Update Restricted Apps

Control which third-party applications have access to your calendar by managing your restricted apps list. This helps protect your calendar privacy and prevent unwanted integrations from syncing data.

Fetch User Profile

Retrieves the authenticated user's profile information including name, email, and account settings. This lets you access and verify the current user's details within your workflow.

Get User Savings

Retrieve your savings metrics and efficiency data tracked by CalendarHero, including time saved and other performance indicators. Use this to measure the productivity gains from your scheduling optimization.

Update User

Modify your profile information including name, email, timezone, and preferences to keep your calendar and account details current.

Update User Address

Modifies the authenticated user's location information using geographic coordinates, enabling accurate location-based meeting scheduling and automatic time zone detection.

Update User Info

Update your CalendarHero profile information such as name, timezone, language, and contact details to keep your account settings current and reflect your business preferences.

Update Work Location

Change where you're working from in your calendar so clients and team members know your current location (office, home, remote, etc.). This helps set accurate availability and meeting expectations based on your physical workspace.

Create Webhook

Set up automatic notifications to your app whenever specific calendar events happen in CalendarHero, enabling real-time updates and seamless workflow automation.

Delete Webhook

Remove a webhook subscription to stop receiving CalendarHero event notifications for a specific event type. Use this when you no longer need to monitor calendar updates or want to clean up outdated integrations.

Get Webhook Configuration

Retrieve the webhook configuration settings for a specific event type to verify if automated notifications are enabled for meetings or contacts. This helps you confirm your integrations are properly set up to trigger actions when calendar events occur.

Get Webhook Sample

Retrieve a sample webhook payload to understand the structure and format of data that CalendarHero will send for specific events. This helps you verify webhook integrations are working correctly and design your application to handle the incoming data.