Create Appointment Task with Tookan API on New Cancelled Event from Google Calendar API

Pipedream makes it easy to connect APIs for Tookan, Google Calendar and 2,200+ other apps remarkably fast.

Trigger workflow on

New Cancelled Event from the Google Calendar API

Next, do this

Create Appointment Task with the Tookan 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 Google Calendar trigger and Tookan action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Cancelled Event trigger
1. Connect your Google Calendar account
2. Configure timer
3. Optional- Select a Calendar ID
Configure the Create Appointment Task action
1. Connect your Tookan account
2. Optional- Configure Additional Options
3. Select a Time Zone
4. Configure Customer Address
5. Configure Job Delivery Date/Time
6. Configure Job Pickup Date/Time
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 Cancelled Event on Google Calendar

Description:Emit new event when a Google Calendar event is cancelled or deleted

Version:0.1.10

Key:google_calendar-event-cancelled

View on GitHub

Google Calendar Overview#

The Google Calendar API lets you dip into the powerhouse of scheduling, allowing for the reading, creation, and manipulation of events and calendars directly from your applications. Through Pipedream, you can seamlessly integrate Google Calendar into a myriad of workflows, automating event management, syncing with other services, setting up custom reminders, or even collating data for reporting. The key here is to streamline your calendar-related processes, ensuring that your time management is as efficient and automated as possible.

Trigger Code#

import common from "../common/common.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "google_calendar-event-cancelled",
  name: "New Cancelled Event",
  description: "Emit new event when a Google Calendar event is cancelled or deleted",
  version: "0.1.10",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    calendarId: {
      propDefinition: [
        common.props.googleCalendar,
        "calendarId",
      ],
    },
  },
  methods: {
    ...common.methods,
    getConfig({
      intervalMs, now,
    }) {
      const updatedMin = new Date(now.getTime() - intervalMs).toISOString();
      return {
        calendarId: this.calendarId,
        updatedMin,
        showDeleted: true,
        singleEvents: true,
        orderBy: "startTime",
      };
    },
    isRelevant(event) {
      return event.status === "cancelled";
    },
  },
  sampleEmit,
};

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
Google Calendar	`googleCalendar`	`app`	This component uses the Google Calendar app.
	`timer`	`$.interface.timer`
Calendar ID	`calendarId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

Google Calendar uses OAuth authentication. When you connect your Google Calendar account, Pipedream will open a popup window where you can sign into Google 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 Google Calendar API.

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

https://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/calendar.settings.readonly

About Google Calendar#

With Google Calendar, you can quickly schedule meetings and events and get reminders about upcoming activities, so you always know what’s next.

Action#

Create Appointment Task on Tookan

Description:Create an appointment task [See docs here](https://tookanapi.docs.apiary.io/#reference/task/create-task/create-an-appointment-task)

Version:0.0.1

Key:tookan-create-appointment-task

View on GitHub

Tookan Overview#

The Tookan API allows for the automation and streamlining of delivery and field services. By integrating with Pipedream, users can trigger workflows based on events within Tookan, such as new task creation, task status updates, or agent alerts. This enables businesses to connect Tookan with other apps and services, automating notifications, data synchronization, and logistics operations, leading to improved coordination, customer satisfaction, and operational efficiency.

Action Code#

import { defineAction } from "@pipedream/types";
import tookan from "../../app/tookan.app.mjs";
import common from "../common.mjs";
export default defineAction({
    ...common,
    name: "Create Appointment Task",
    description: "Create an appointment task [See docs here](https://tookanapi.docs.apiary.io/#reference/task/create-task/create-an-appointment-task)",
    key: "tookan-create-appointment-task",
    version: "0.0.1",
    type: "action",
    props: {
        ...common.props,
        customerAddress: {
            propDefinition: [
                tookan,
                "customerAddress",
            ],
        },
        jobDeliveryDatetime: {
            propDefinition: [
                tookan,
                "jobDeliveryDatetime",
            ],
        },
        jobPickupDatetime: {
            propDefinition: [
                tookan,
                "jobPickupDatetime",
            ],
        },
    },
    async run({ $ }) {
        const params = {
            $,
            data: {
                timezone: this.timezone,
                customer_address: this.customerAddress,
                job_delivery_datetime: this.jobDeliveryDatetime,
                job_pickup_datetime: this.jobPickupDatetime,
                has_delivery: 0,
                has_pickup: 0,
                layout_type: 1,
                ...this.additionalOptions,
            },
        };
        const data = await this.tookan.createAppointmentTask(params);
        $.export("$summary", `Created appointment task successfully (id ${data.job_id})`);
        return data;
    },
});

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
Tookan	`tookan`	`app`	This component uses the Tookan app.
Additional Options	`additionalOptions`	`object`	Any optional parameters to pass to the request (see the Tookan API docs for available parameters)
Time Zone	`timezone`	`string`	Select a value from the drop down menu:`{ "label": "UTC -8 (PST)", "value": "-480" }{ "label": "UTC -7 (MST)", "value": "-420" }{ "label": "UTC -6 (CST)", "value": "-360" }{ "label": "UTC -5 (EST)", "value": "-300" }{ "label": "UTC -4 (AST)", "value": "-240" }{ "label": "UTC -3 (BRT)", "value": "-180" }{ "label": "UTC -2", "value": "-120" }{ "label": "UTC -1", "value": "-60" }{ "label": "UTC 0 (GMT)", "value": "0" }{ "label": "UTC +1 (CET)", "value": "+60" }{ "label": "UTC +2 (EET)", "value": "+120" }{ "label": "UTC +3 (MSK)", "value": "+180" }{ "label": "UTC +4", "value": "+240" }`
Customer Address	`customerAddress`	`string`	This is the address of the customer to whom the product should be delivered
Job Delivery Date/Time	`jobDeliveryDatetime`	`string`	This is the time before which the product should be delivered. Use a date/time string in the format `2016-08-14 19:00:00`
Job Pickup Date/Time	`jobPickupDatetime`	`string`	This is time before which the pickup should be collected. Use a date/time string in the format `2016-08-14 19:00:00`

Action Authentication#

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

To retrieve your API key,
Navigate to your Tookan account and sign in
Go to “Settings” > “API Keys”

About Tookan#

Tookan is an off the shelf solution to manage and track, field workforces that enable on-demand deliveries.

More Ways to Connect Tookan + Google Calendar#

Other Popular Integrations#

Create Appointment Task with Tookan API on Event Ended from Google Calendar API

Google Calendar + Tookan

Create Appointment Task with Tookan API on New Cancelled Event from Google Calendar API

Pipedream makes it easy to connect APIs for Tookan, Google Calendar and 2,200+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,200+apps by most popular

1
-
24
of
2,200+
apps by most popular