How to Access Calendly API to Manage Scheduling in Node.js

Set Up Authentication

• Calendly uses OAuth 2.0 for authentication. You will need to obtain a personal access token or execute an OAuth handshake to interact with Calendly's API.

 

• To proceed, ensure you have a personal access token ready for use. You can generate this token from Calendly's developer portal. Remember, keep your token secure and do not expose it publicly.

Initialize a Node.js Project

• Create a new directory for your project and navigate into it. Use the following command to create a new `package.json` file.

npm init -y

• Install necessary packages. You'll need `axios` for making HTTP requests and `dotenv` for loading environment variables.

npm install axios dotenv

Create .env File

• Create a `.env` file in your project root to store your sensitive credentials. Add your Calendly access token here.

CALENDLY_ACCESS_TOKEN=your_access_token_here

Set Up Axios Instance with Authentication

• Create a new file named `apiClient.js`. This will handle all your API requests and manage authentication headers.

require('dotenv').config();
const axios = require('axios');

const apiClient = axios.create({
  baseURL: 'https://api.calendly.com',
  headers: {
    Authorization: `Bearer ${process.env.CALENDLY_ACCESS_TOKEN}`,
    'Content-Type': 'application/json',
  },
});

module.exports = apiClient;

Fetch Scheduled Events

• Create `getEvents.js` to fetch scheduled events using the Calendly API.

const apiClient = require('./apiClient');

async function getScheduledEvents() {
  try {
    const response = await apiClient.get('/scheduled_events');
    return response.data;
  } catch (error) {
    console.error('Error fetching scheduled events:', error);
  }
}

module.exports = getScheduledEvents;

Cancel an Event

• Implement functionality to cancel an existing scheduled event. Create a file named `cancelEvent.js` and add the following code.

const apiClient = require('./apiClient');

async function cancelEvent(eventUri) {
  try {
    const response = await apiClient.post(`${eventUri}/cancellation`, {
      reason: 'The reason for cancellation'
    });
    return response.data;
  } catch (error) {
    console.error('Error cancelling event:', error);
  }
}

module.exports = cancelEvent;

Integrate with Your Application

• In your main application file, e.g., `app.js`, you can now call these functions as required by your business logic.

const getScheduledEvents = require('./getEvents');
const cancelEvent = require('./cancelEvent');

(async () => {
  const events = await getScheduledEvents();
  console.log('Scheduled Events:', events);

  // Example of cancelling an event using its URI
  if (events.length > 0) {
    const eventUri = events[0].uri; // Get the URI of the first event
    await cancelEvent(eventUri);
    console.log('Event cancelled successfully');
  }
})();

• With the functions properly set up, you can now manage your Calendly scheduling events programmatically from your Node.js application.
• For additional functionalities, you can explore the full Calendly API documentation and integrate other endpoints similarly.