Create Agenda Period with Booking Experts API on New Appointment Created from Setmore API

Pipedream makes it easy to connect APIs for Booking Experts, Setmore and 2,900+ other apps remarkably fast.

Trigger workflow on

New Appointment Created from the Setmore API

Next, do this

Create Agenda Period with the Booking Experts 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 Setmore trigger and Booking Experts action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Appointment Created trigger
1. Connect your Setmore account
2. Configure timer
3. Optional- Select a Staff
Configure the Create Agenda Period action
1. Connect your Booking Experts account
2. Select a Administration ID
3. Select a Type
4. Configure Label
5. Configure Start Date
6. Configure End Date
7. Optional- Select a Inventory Object ID
8. Select a Rentable ID
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 Appointment Created on Setmore

Description:Emit new event when a new appointment is created in Setmore. [See the documentation](https://setmore.docs.apiary.io/#introduction/appointments/fetch-appointments-by-date-range)

Version:0.0.1

Key:setmoreappointments-new-appointment-created

View on GitHub

Setmore Overview#

The Setmore API opens doors to automating appointment scheduling and calendar management, allowing you to sync appointments, customer information, and services across different platforms. This seamless integration through Pipedream can trigger workflows from new appointments, update external CRMs with customer data, or prep team communication channels with upcoming schedule details. By harnessing the Setmore API on Pipedream, you're equipping yourself to orchestrate complex operations with simplicity and precision.

Trigger Code#

import setmore from "../../setmoreappointments.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
import sampleEmit from "./test-event.mjs";

export default {
  key: "setmoreappointments-new-appointment-created",
  name: "New Appointment Created",
  description: "Emit new event when a new appointment is created in Setmore. [See the documentation](https://setmore.docs.apiary.io/#introduction/appointments/fetch-appointments-by-date-range)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    setmore,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    staffKey: {
      propDefinition: [
        setmore,
        "staffKey",
      ],
      optional: true,
    },
  },
  methods: {
    _getLastDate() {
      return this.db.get("lastDate") || this.getMonthAgo();
    },
    _setLastDate(lastDate) {
      this.db.set("lastDate", lastDate);
    },
    getMonthAgo() {
      const now = new Date();
      const oneMonthAgo = new Date(now);
      oneMonthAgo.setMonth(oneMonthAgo.getMonth() - 1);
      return this.formatDate(oneMonthAgo);
    },
    getToday() {
      const now = new Date();
      return this.formatDate(now);
    },
    getYearFromNow() {
      const now = new Date();
      now.setFullYear(now.getFullYear() + 1);
      return this.formatDate(now);
    },
    formatDate(date) {
      const day = String(date.getDate()).padStart(2, "0");
      const month = String(date.getMonth() + 1).padStart(2, "0");
      const year = date.getFullYear();
      return `${day}-${month}-${year}`;
    },
    generateMeta(appointment) {
      return {
        id: appointment.key,
        summary: `New Appointment with Key: ${appointment.key}`,
        ts: Date.now(),
      };
    },
  },
  async run() {
    const startDate = this._getLastDate();
    const endDate = this.getYearFromNow();

    const appointments = this.setmore.paginate({
      resourceFn: this.setmore.listAppointments,
      resourceKey: "appointments",
      params: {
        startDate,
        endDate,
        staff_key: this.staffKey,
        customerDetails: true,
      },
    });

    for await (const appointment of appointments) {
      const meta = this.generateMeta(appointment);
      this.$emit(appointment, meta);
    }

    this._setLastDate(this.getToday());
  },
  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
Setmore	`setmore`	`app`	This component uses the Setmore app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Staff	`staffKey`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

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

About Setmore#

Setmore offers a free, online scheduling platform for you to connect with your customers.

Action#

Create Agenda Period on Booking Experts

Description:Creates a new agenda period. [See the documentation](https://developers.bookingexperts.com/reference/administration-maintenance-agenda-periods-create)

Version:0.0.2

Key:booking_experts-create-agenda-period

View on GitHub

Action Code#

import bookingExperts from "../../booking_experts.app.mjs";

export default {
  key: "booking_experts-create-agenda-period",
  name: "Create Agenda Period",
  description: "Creates a new agenda period. [See the documentation](https://developers.bookingexperts.com/reference/administration-maintenance-agenda-periods-create)",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    bookingExperts,
    administrationId: {
      propDefinition: [
        bookingExperts,
        "administrationId",
      ],
    },
    type: {
      type: "string",
      label: "Type",
      description: "The type of agenda period to create",
      options: [
        "maintenance_agenda_periods",
        "external_blocked_agenda_periods",
      ],
    },
    label: {
      type: "string",
      label: "Label",
      description: "The label of the agenda period",
    },
    startDate: {
      type: "string",
      label: "Start Date",
      description: "The start date of the agenda period. Example: `2025-08-28`",
    },
    endDate: {
      type: "string",
      label: "End Date",
      description: "The end date of the agenda period",
    },
    inventoryObjectId: {
      propDefinition: [
        bookingExperts,
        "inventoryObjectId",
        (c) => ({
          administrationId: c.administrationId,
        }),
      ],
    },
    rentableId: {
      propDefinition: [
        bookingExperts,
        "rentableId",
        (c) => ({
          administrationId: c.administrationId,
          inventoryObjectId: c.inventoryObjectId,
        }),
      ],
    },
  },
  async run({ $ }) {
    const { data } = await this.bookingExperts.createAgendaPeriod({
      $,
      administrationId: this.administrationId,
      type: this.type,
      data: {
        data: {
          type: "agenda_period",
          attributes: {
            label: this.label,
            start_date: this.startDate,
            end_date: this.endDate,
          },
          relationships: {
            inventory_object: this.inventoryObjectId
              ? {
                data: {
                  type: "inventory_object",
                  id: this.inventoryObjectId,
                },
              }
              : undefined,
            rentable: {
              data: {
                type: "rentable",
                id: this.rentableId,
              },
            },
          },
        },
      },
    });
    $.export("$summary", "Agenda period created");
    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
Booking Experts	`bookingExperts`	`app`	This component uses the Booking Experts app.
Administration ID	`administrationId`	`string`	Select a value from the drop down menu.
Type	`type`	`string`	Select a value from the drop down menu:`maintenance_agenda_periodsexternal_blocked_agenda_periods`
Label	`label`	`string`	The label of the agenda period
Start Date	`startDate`	`string`	The start date of the agenda period. Example: `2025-08-28`
End Date	`endDate`	`string`	The end date of the agenda period
Inventory Object ID	`inventoryObjectId`	`string`	Select a value from the drop down menu.
Rentable ID	`rentableId`	`string`	Select a value from the drop down menu.

Create Agenda Period with Booking Experts API on New Appointment Created from Setmore API

Pipedream makes it easy to connect APIs for Booking Experts, Setmore and 2,900+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,900+apps by most popular

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