Create Booking Business with Microsoft Bookings API

Pipedream makes it easy to connect APIs for Microsoft Bookings and 3,000+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Create Booking Business with the Microsoft Bookings 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#

Create a workflow to Create Booking Business with the Microsoft Bookings API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Create Booking Business action
1. Connect your Microsoft Bookings account
2. Configure Display Name
3. Optional- Configure Email
4. Optional- Configure Phone
5. Optional- Configure Website URL
6. Optional- Configure Street
7. Optional- Configure City
8. Optional- Configure State
9. Optional- Configure Postal Code
10. Optional- Configure Country or Region
11. Optional- Configure Default Currency
12. Optional- Configure Business Type
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is 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.

Create Booking Business on Microsoft Bookings

Description:Creates a new Microsoft Bookings business. [See the documentation](https://learn.microsoft.com/en-us/graph/api/bookingbusiness-post-bookingbusinesses?view=graph-rest-1.0)

Version:0.0.1

Key:microsoft_bookings-create-business

View on GitHub

Code#

import app from "../../microsoft_bookings.app.mjs";

export default {
  key: "microsoft_bookings-create-business",
  name: "Create Booking Business",
  description: "Creates a new Microsoft Bookings business. [See the documentation](https://learn.microsoft.com/en-us/graph/api/bookingbusiness-post-bookingbusinesses?view=graph-rest-1.0)",
  version: "0.0.1",
  type: "action",
  annotations: {
    readOnlyHint: false,
    destructiveHint: false,
    openWorldHint: true,
  },
  props: {
    app,
    displayName: {
      type: "string",
      label: "Display Name",
      description: "The name of the business, which interfaces with customers",
    },
    email: {
      type: "string",
      label: "Email",
      description: "The email address for the business",
      optional: true,
    },
    phone: {
      type: "string",
      label: "Phone",
      description: "The telephone number for the business",
      optional: true,
    },
    webSiteUrl: {
      type: "string",
      label: "Website URL",
      description: "The URL of the business web site",
      optional: true,
    },
    street: {
      type: "string",
      label: "Street",
      description: "The street address of the business",
      optional: true,
    },
    city: {
      type: "string",
      label: "City",
      description: "The city of the business",
      optional: true,
    },
    state: {
      type: "string",
      label: "State",
      description: "The state of the business",
      optional: true,
    },
    postalCode: {
      type: "string",
      label: "Postal Code",
      description: "The postal code of the business",
      optional: true,
    },
    countryOrRegion: {
      type: "string",
      label: "Country or Region",
      description: "The country or region of the business",
      optional: true,
    },
    defaultCurrencyIso: {
      type: "string",
      label: "Default Currency",
      description: "The code for the currency that the business operates in (e.g. USD)",
      optional: true,
    },
    businessType: {
      type: "string",
      label: "Business Type",
      description: "The type of business",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      app,
      displayName,
      email,
      phone,
      webSiteUrl,
      street,
      city,
      state,
      postalCode,
      countryOrRegion,
      defaultCurrencyIso,
      businessType,
    } = this;

    const address = {};
    if (street) address.street = street;
    if (city) address.city = city;
    if (state) address.state = state;
    if (postalCode) address.postalCode = postalCode;
    if (countryOrRegion) address.countryOrRegion = countryOrRegion;

    const content = {
      displayName,
    };

    if (email) content.email = email;
    if (phone) content.phone = phone;
    if (webSiteUrl) content.webSiteUrl = webSiteUrl;
    if (Object.keys(address).length > 0) content.address = address;
    if (defaultCurrencyIso) content.defaultCurrencyIso = defaultCurrencyIso;
    if (businessType) content.businessType = businessType;

    const response = await app.createBusiness({
      content,
    });

    $.export("$summary", `Successfully created business: ${displayName}`);

    return response;
  },
};

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
Microsoft Bookings	`app`	`app`	This component uses the Microsoft Bookings app.
Display Name	`displayName`	`string`	The name of the business, which interfaces with customers
Email	`email`	`string`	The email address for the business
Phone	`phone`	`string`	The telephone number for the business
Website URL	`webSiteUrl`	`string`	The URL of the business web site
Street	`street`	`string`	The street address of the business
City	`city`	`string`	The city of the business
State	`state`	`string`	The state of the business
Postal Code	`postalCode`	`string`	The postal code of the business
Country or Region	`countryOrRegion`	`string`	The country or region of the business
Default Currency	`defaultCurrencyIso`	`string`	The code for the currency that the business operates in (e.g. USD)
Business Type	`businessType`	`string`	The type of business

Authentication#

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

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

emailoffline_accessopenidprofileBookings.Manage.AllBookings.Read.AllBookings.ReadWrite.AllBookingsAppointment.ReadWrite.All