Get Free/Busy Schedule with Microsoft Outlook Calendar API on New Task Created from Magnetic API

Pipedream makes it easy to connect APIs for Microsoft Outlook Calendar, Magnetic and 2,900+ other apps remarkably fast.

Trigger workflow on

New Task Created from the Magnetic API

Next, do this

Get Free/Busy Schedule with the Microsoft Outlook Calendar API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Magnetic trigger and Microsoft Outlook Calendar action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Task Created trigger
1. Connect your Magnetic account
2. Configure timer
Configure the Get Free/Busy Schedule action
1. Connect your Microsoft Outlook Calendar account
2. Configure Schedules
3. Configure Start
4. Configure End
5. Select a Time Zone
6. Optional- Configure Availability View Interval
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Task Created on Magnetic

Description:Emit new event when a new task is created [See docs here](https://app.magnetichq.com/Magnetic/API.do#ta-taskobject)

Version:0.0.1

Key:magnetic-new-task-created

View on GitHub

Magnetic Overview#

Magnetic is a project management and workflow automation platform designed to help agencies stay organized and streamline operations. With the Magnetic API on Pipedream, you can automate routine tasks, sync data across various apps, and create custom workflows to enhance productivity. From task creation and time tracking to financial management and reporting, Pipedream’s serverless execution model lets you connect Magnetic with a plethora of other services without the need for a dedicated server setup.

Trigger Code#

import magnetic from "../../magnetic.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  key: "magnetic-new-task-created",
  name: "New Task Created",
  description: "Emit new event when a new task is created [See docs here](https://app.magnetichq.com/Magnetic/API.do#ta-taskobject)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    magnetic,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  hooks: {
    async deploy() {
      const tasks = await this.magnetic.listTasks();
      if (!(tasks?.length > 0)) {
        return;
      }
      this._setLastCreated(tasks[tasks.length - 1].createdDate);
      tasks.slice(-25).reverse()
        .forEach((task) => this.emitEvent(task));
    },
  },
  methods: {
    _getLastCreated() {
      return this.db.get("lastCreated") || 0;
    },
    _setLastCreated(lastCreated) {
      this.db.set("lastCreated", lastCreated);
    },
    emitEvent(event) {
      const meta = this.generateMeta(event);
      this.$emit(event, meta);
    },
    isRelevant(createdDate, lastCreated) {
      return createdDate > lastCreated;
    },
    generateMeta(task) {
      return {
        id: task.id,
        summary: task.task,
        ts: task.createdDate,
      };
    },
  },
  async run() {
    const tasks = await this.magnetic.listTasks();
    if (!(tasks?.length > 0)) {
      return;
    }

    const lastCreated = this._getLastCreated();
    this._setLastCreated(tasks[tasks.length - 1].createdDate);

    for (const task of tasks) {
      if (this.isRelevant(task.createdDate, lastCreated)) {
        this.emitEvent(task);
      }
    }
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Magnetic	`magnetic`	`app`	This component uses the Magnetic app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

Magnetic uses API keys for authentication. When you connect your Magnetic account, Pipedream securely stores the keys so you can easily authenticate to Magnetic APIs in both code and no-code steps.

Your token can be found on your Personal Settings page, under the API section, here

About Magnetic#

Magnetic Software is a single integrated cloud Project Management, Sales CRM & Accounts platform.

Action#

Get Free/Busy Schedule on Microsoft Outlook Calendar

Description:Get the free/busy availability information for a collection of users, distributions lists, or resources (rooms or equipment) for a specified time period. [See the documentation](https://learn.microsoft.com/en-us/graph/api/calendar-getschedule)

Version:0.0.5

Key:microsoft_outlook_calendar-get-schedule

View on GitHub

Microsoft Outlook Calendar Overview#

The Microsoft Outlook Calendar API provides programmatic access to a user's calendar events, allowing for the creation, retrieval, update, and deletion of events within Outlook calendars. With Pipedream, you can integrate these calendar operations into workflows that automate tasks involving scheduling, event management, and coordination with other services. Whether it's triggering actions when new events are created, syncing calendar events with other scheduling tools, or managing attendees, Pipedream's serverless platform enables you to build custom automations with minimal overhead.

Action Code#

import { ConfigurationError } from "@pipedream/platform";
import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
import utils from "../../common/utils.mjs";

export default {
  key: "microsoft_outlook_calendar-get-schedule",
  name: "Get Free/Busy Schedule",
  description: "Get the free/busy availability information for a collection of users, distributions lists, or resources (rooms or equipment) for a specified time period. [See the documentation](https://learn.microsoft.com/en-us/graph/api/calendar-getschedule)",
  version: "0.0.5",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: true,
  },
  type: "action",
  props: {
    microsoftOutlook,
    schedules: {
      type: "string[]",
      label: "Schedules",
      description: "A list of emails of users, distribution lists, or resources. For example: `[ \"adelev@contoso.com\" , \"meganb@contoso.com\" ]`",
    },
    start: {
      propDefinition: [
        microsoftOutlook,
        "start",
      ],
    },
    end: {
      propDefinition: [
        microsoftOutlook,
        "end",
      ],
    },
    timeZone: {
      propDefinition: [
        microsoftOutlook,
        "timeZone",
      ],
    },
    availabilityViewInterval: {
      type: "integer",
      label: "Availability View Interval",
      description: "Represents the duration of a time slot in minutes in an availabilityView in the response. The default is 30 minutes, minimum is 5, maximum is 1440.",
      optional: true,
    },
  },
  methods: {
    getSchedule(opts = {}) {
      return this.microsoftOutlook._makeRequest({
        method: "POST",
        path: "/me/calendar/getSchedule",
        ...opts,
      });
    },
  },
  async run({ $ }) {
    if (this.schedules === null || this.schedules === undefined || this.schedules?.length === 0) {
      throw new ConfigurationError("The **Schedules** property is required");
    }

    const schedules = utils.parseArray(this.schedules);

    const { value } = await this.getSchedule({
      $,
      data: {
        schedules,
        startTime: {
          dateTime: this.start,
          timeZone: this.timeZone,
        },
        endTime: {
          dateTime: this.end,
          timeZone: this.timeZone,
        },
        availabilityViewInterval: this.availabilityViewInterval,
      },
    });

    $.export("$summary", `Successfully retrieved schedules for \`${schedules.join("`, `")}\``);

    return value;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Microsoft Outlook Calendar	`microsoftOutlook`	`app`	This component uses the Microsoft Outlook Calendar app.
Schedules	`schedules`	`string[]`	A list of emails of users, distribution lists, or resources. For example: `[ "adelev@contoso.com" , "meganb@contoso.com" ]`
Start	`start`	`string`	Start date-time (yyyy-MM-ddThh:mm:ss) e.g. '2022-04-15T11:20:00'
End	`end`	`string`	End date-time (yyyy-MM-ddThh:mm:ss) e.g. '2022-04-15T13:30:00'
Time Zone	`timeZone`	`string`	Select a value from the drop down menu.
Availability View Interval	`availabilityViewInterval`	`integer`	Represents the duration of a time slot in minutes in an availabilityView in the response. The default is 30 minutes, minimum is 5, maximum is 1440.

Action Authentication#

Microsoft Outlook Calendar uses OAuth authentication. When you connect your Microsoft Outlook Calendar account, Pipedream will open a popup window where you can sign into Microsoft Outlook Calendar and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Microsoft Outlook Calendar API.

Pipedream requests the following authorization scopes when you connect your account:

User.Reademailoffline_accessopenidprofileCalendars.ReadWrite

About Microsoft Outlook Calendar#

The calendar and scheduling component of Outlook that is fully integrated with email, contacts, and other features

More Ways to Connect Microsoft Outlook Calendar + Magnetic#

Other Popular Integrations#

Create Calendar Event with Microsoft Outlook Calendar API on New Task Created from Magnetic API

Magnetic + Microsoft Outlook Calendar

Try it

Update Calendar Event with Microsoft Outlook Calendar API on New Task Created from Magnetic API

Magnetic + Microsoft Outlook Calendar

Try it

Delete Calendar Event with Microsoft Outlook Calendar API on New Task Created from Magnetic API

Magnetic + Microsoft Outlook Calendar

Try it

List Events with Microsoft Outlook Calendar API on New Task Created from Magnetic API

Magnetic + Microsoft Outlook Calendar

Try it

Create Contact with Magnetic API on New Calendar Event (Instant) from Microsoft Outlook Calendar API

Microsoft Outlook Calendar + Magnetic

Try it

Popular Triggers#

New Task Created from the Magnetic API

Emit new event when a new task is created See docs here

Try it

New Calendar Event (Instant) from the Microsoft Outlook Calendar API

Emit new event when a new Calendar event is created

Try it

New Calendar Event Update (Instant) from the Microsoft Outlook Calendar API

Emit new event when a Calendar event is updated

Try it

New Upcoming Calendar Event from the Microsoft Outlook Calendar API

Emit new event when a Calendar event is upcoming, this source is using reminderMinutesBeforeStart property of the event to determine the time it should emit.

Try it