Update Reservation with Mews API on New Interview Response from Async Interview API

Pipedream makes it easy to connect APIs for Mews, Async Interview and 2,800+ other apps remarkably fast.

Trigger workflow on

New Interview Response from the Async Interview API

Next, do this

Update Reservation with the Mews 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 Async Interview trigger and Mews action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Interview Response trigger
1. Connect your Async Interview account
2. Configure timer
Configure the Update Reservation action
1. Connect your Mews account
2. Optional- Configure Reason
3. Optional- Configure Reprice
4. Optional- Configure Apply Cancellation Fee
5. Select a Reservation ID
6. Optional- Configure Channel Number
7. Optional- Configure Start UTC
8. Optional- Configure End UTC
9. Optional- Configure Released UTC
10. Optional- Configure Person Counts
11. Optional- Configure Assigned Resource ID
12. Optional- Configure Requested Category ID
13. Optional- Select a Travel Agency ID
14. Optional- Select a Company ID
15. Optional- Select a Business Segment ID
16. Optional- Configure Purpose
17. Optional- Select a Rate ID
18. Optional- Select a Credit Card ID
19. Optional- Configure Time Unit Prices
20. Select a Booker ID
21. Optional- Configure Assigned Resource Locked
22. Optional- Select a Availability Block ID
23. Optional- Configure Options Owner Checked In
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 Interview Response on Async Interview

Description:Emit new event when a new interview response is received.

Version:0.0.1

Key:async_interview-new-interview-response

View on GitHub

Async Interview Overview#

The Async Interview API enables automation around video interview processes. With this API, you can craft workflows on Pipedream that manipulate interview data, initiate new interviews, and respond to events within the Async Interview platform. Pipedream's serverless architecture allows you to connect with hundreds of apps to streamline recruitment workflows, analyze interview data, or enhance the candidate experience with personalized interactions.

Trigger Code#

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

export default {
  key: "async_interview-new-interview-response",
  name: "New Interview Response",
  description: "Emit new event when a new interview response is received.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    asyncInterview,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    _getLastId() {
      return this.db.get("lastId") || 0;
    },
    _setLastId(lastId) {
      this.db.set("lastId", lastId);
    },
    generateMeta(event) {
      return {
        id: event.id,
        summary: `New interview response with ID ${event.id}`,
        ts: Date.parse(event.datetime),
      };
    },
    async startEvent(maxResults = 0) {
      const lastId = this._getLastId();

      let data = await this.asyncInterview.listInterviewResponses();

      data = data.filter((item) => item.id > lastId).reverse();

      if (maxResults && (data.length > maxResults)) data.length = maxResults;
      if (data.length) this._setLastId(data[0].id);

      for (const item of data.reverse()) {
        this.$emit(item, this.generateMeta(item));
      }
    },
  },
  hooks: {
    async deploy() {
      await this.startEvent(25);
    },
  },
  async run() {
    await this.startEvent();
  },
  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
Async Interview	`asyncInterview`	`app`	This component uses the Async Interview app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

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

About Async Interview#

Async Interview is the world’s most advanced video interviewing platform, offering pre-recorded interviews customized to meet any recruitment scenario.

Action#

Update Reservation on Mews

Description:Update an existing reservation in Mews. [See the documentation](https://mews-systems.gitbook.io/connector-api/operations/reservations#update-reservations)

Version:0.0.2

Key:mews-update-reservation

View on GitHub

Mews Overview#

The Mews API is a gateway for developers to interact with the Mews hospitality platform, allowing for innovative connections and automations between hotel management systems and other software tools. By using Pipedream, you can create custom workflows that automate repetitive tasks, integrate with numerous third-party services, and manipulate data to suit specific needs within the hospitality industry. The combination of Mews' API and Pipedream's serverless execution model paves the way for enhanced guest experiences, optimized operations, and real-time data handling.

Action Code#

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

export default {
  name: "Update Reservation",
  description: "Update an existing reservation in Mews. [See the documentation](https://mews-systems.gitbook.io/connector-api/operations/reservations#update-reservations)",
  key: "mews-update-reservation",
  version: "0.0.2",
  type: "action",
  props: {
    app,
    reason: {
      type: "string",
      label: "Reason",
      description: "Reason for updating the reservation. Required when updating the price of the reservation.",
      optional: true,
    },
    reprice: {
      type: "boolean",
      label: "Reprice",
      description: "Whether the price should be updated to latest value for date/rate/category combination set in Mews. If not specified, the reservation price is updated.",
      optional: true,
    },
    applyCancellationFee: {
      type: "boolean",
      label: "Apply Cancellation Fee",
      description: "Whether the cancellation fees should be applied according to rate cancellation policies. If not specified, the cancellation fees are applied.",
      optional: true,
    },
    reservationId: {
      propDefinition: [
        app,
        "reservationId",
      ],
      description: "Unique identifier of the reservation.",
    },
    channelNumber: {
      type: "string",
      label: "Channel Number",
      description: "Number of the reservation within the Channel (i.e. OTA, GDS, CRS, etc) in case the reservation group originates there (e.g. Booking.com confirmation number)",
      optional: true,
    },
    startUtc: {
      type: "string",
      label: "Start UTC",
      description: "Reservation start in UTC timezone in ISO 8601 format",
      optional: true,
    },
    endUtc: {
      type: "string",
      label: "End UTC",
      description: "Reservation end in UTC timezone in ISO 8601 format",
      optional: true,
    },
    releasedUtc: {
      type: "string",
      label: "Released UTC",
      description: "Date when the optional reservation is released in UTC timezone in ISO 8601 format",
      optional: true,
    },
    personCounts: {
      type: "string[]",
      label: "Person Counts",
      description: `Number of people per age category the reservation is for. If supplied, the person counts will be replaced. Each item should contain:
- \`AgeCategoryId\` (string, required): Unique identifier of the Age category
- \`Count\` (integer, required): Number of people of a given age category. Only positive value is accepted

Pass an array of person counts or null if the person counts should not be updated.

**Example:**
\`\`\`json
[
  {
    "AgeCategoryId": "12345678-1234-1234-1234-123456789012",
    "Count": 2
  },
  {
    "AgeCategoryId": "87654321-4321-4321-4321-210987654321",
    "Count": 1
  }
]
\`\`\``,
      optional: true,
    },
    assignedResourceId: {
      type: "string",
      label: "Assigned Resource ID",
      description: "Identifier of the assigned Resource. If the assigned resource is locked, see AssignedResourceLocked for updating the assigned resource.",
      optional: true,
    },
    requestedCategoryId: {
      type: "string",
      label: "Requested Category ID",
      description: "Identifier of the requested ResourceCategory",
      optional: true,
    },
    travelAgencyId: {
      label: "Travel Agency ID",
      description: "Identifier of the Travel Agency. (Company with a TravelAgencyContract)",
      propDefinition: [
        app,
        "companyId",
        () => ({
          filter: (company) => {
            return company.NchClassifications?.OnlineTravelAgency === true;
          },
        }),
      ],
      optional: true,
    },
    companyId: {
      propDefinition: [
        app,
        "companyId",
      ],
      description: "Unique identifier of Company.",
      optional: true,
    },
    businessSegmentId: {
      propDefinition: [
        app,
        "businessSegmentId",
      ],
      description: "Unique identifier of BusinessSegment.",
      optional: true,
    },
    purpose: {
      type: "string",
      label: "Purpose",
      description: "Purpose of the reservation",
      optional: true,
    },
    rateId: {
      propDefinition: [
        app,
        "rateId",
      ],
    },
    creditCardId: {
      propDefinition: [
        app,
        "creditCardId",
      ],
    },
    timeUnitPrices: {
      type: "string[]",
      label: "Time Unit Prices",
      description: `Prices for time units of the reservation. Each unit should contain:
- \`Index\` (integer, required): Index of the unit starting with 0 (e.g., first night has index 0)
- \`Amount\` (object, optional): Amount parameters including:
  - \`GrossValue\` (decimal, optional): Amount including tax (required for Gross Pricing environments)
  - \`NetValue\` (decimal, optional): Amount excluding tax (required for Net Pricing environments)
  - \`Currency\` (string, required): \`ISO-4217\` code of the currency
  - \`TaxCodes\` (array of strings, required): Codes of tax rates to be applied (note: only one tax when using \`GrossValue\`, multiple taxes with \`NetValue\`)

Pass an array of price units or null if the unit amounts should not be updated.

**Example:**
\`\`\`json
[
  {
    "Index": 0,
    "Amount": {
      "GrossValue": 100.00,
      "Currency": "EUR",
      "TaxCodes": ["VAT"]
    }
  },
  {
    "Index": 1,
    "Amount": {
      "NetValue": 85.00,
      "Currency": "EUR",
      "TaxCodes": ["VAT", "CityTax"]
    }
  }
]
\`\`\``,
      optional: true,
    },
    bookerId: {
      label: "Booker ID",
      description: "Identifier of the Customer on whose behalf the reservation was made.",
      propDefinition: [
        app,
        "customerId",
      ],
    },
    assignedResourceLocked: {
      type: "boolean",
      label: "Assigned Resource Locked",
      description: "Whether the reservation should be locked to the assigned Resource. To reassign the reservation to a new Resource, first set AssignedResourceLocked to false to unlock the resource. Then, assign the reservation to a new Resource by setting AssignedResourceId to the new resource ID.",
      optional: true,
    },
    availabilityBlockId: {
      propDefinition: [
        app,
        "availabilityBlockId",
      ],
    },
    optionsOwnerCheckedIn: {
      type: "boolean",
      label: "Options Owner Checked In",
      description: "Whether the owner of the reservation has checked in.",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      app,
      reason,
      reprice,
      applyCancellationFee,
      reservationId,
      channelNumber,
      startUtc,
      endUtc,
      releasedUtc,
      personCounts,
      assignedResourceId,
      requestedCategoryId,
      travelAgencyId,
      companyId,
      businessSegmentId,
      purpose,
      rateId,
      creditCardId,
      timeUnitPrices,
      bookerId,
      assignedResourceLocked,
      availabilityBlockId,
      optionsOwnerCheckedIn,
    } = this;

    // Parse arrays
    const parsedPersonCounts = personCounts
      ? utils.parseArray(personCounts)
      : undefined;
    const parsedTimeUnitPrices = timeUnitPrices
      ? utils.parseArray(timeUnitPrices)
      : undefined;

    // Validate arrays
    if (parsedPersonCounts && !Array.isArray(parsedPersonCounts)) {
      throw new ConfigurationError("**Person Counts** must be an array when provided");
    }

    if (parsedTimeUnitPrices && !Array.isArray(parsedTimeUnitPrices)) {
      throw new ConfigurationError("**Time Unit Prices** must be an array when provided");
    }

    const response = await app.reservationsUpdate({
      $,
      data: {
        Reason: reason,
        Reprice: reprice,
        ApplyCancellationFee: applyCancellationFee,
        ReservationUpdates: [
          {
            ReservationId: reservationId,
            ...(channelNumber && {
              ChannelNumber: {
                Value: channelNumber,
              },
            }),
            ...(startUtc && {
              StartUtc: {
                Value: startUtc,
              },
            }),
            ...(endUtc && {
              EndUtc: {
                Value: endUtc,
              },
            }),
            ...(releasedUtc && {
              ReleasedUtc: {
                Value: releasedUtc,
              },
            }),
            ...(parsedPersonCounts && {
              PersonCounts: {
                Value: parsedPersonCounts,
              },
            }),
            ...(assignedResourceId && {
              AssignedResourceId: {
                Value: assignedResourceId,
              },
            }),
            ...(requestedCategoryId && {
              RequestedCategoryId: {
                Value: requestedCategoryId,
              },
            }),
            ...(travelAgencyId && {
              TravelAgencyId: {
                Value: travelAgencyId,
              },
            }),
            ...(companyId && {
              CompanyId: {
                Value: companyId,
              },
            }),
            ...(businessSegmentId && {
              BusinessSegmentId: {
                Value: businessSegmentId,
              },
            }),
            ...(purpose && {
              Purpose: {
                Value: purpose,
              },
            }),
            ...(rateId && {
              RateId: {
                Value: rateId,
              },
            }),
            ...(creditCardId && {
              CreditCardId: {
                Value: creditCardId,
              },
            }),
            ...(parsedTimeUnitPrices && {
              TimeUnitPrices: {
                Value: parsedTimeUnitPrices,
              },
            }),
            ...(bookerId && {
              BookerId: {
                Value: bookerId,
              },
            }),
            ...(assignedResourceLocked !== undefined && {
              AssignedResourceLocked: {
                Value: assignedResourceLocked,
              },
            }),
            ...(availabilityBlockId && {
              AvailabilityBlockId: {
                Value: availabilityBlockId,
              },
            }),
            ...(optionsOwnerCheckedIn !== undefined && {
              Options: {
                OwnerCheckedIn: {
                  Value: optionsOwnerCheckedIn,
                },
              },
            }),
          },
        ],
      },
    });

    $.export("$summary", `Successfully updated reservation ${reservationId}`);
    return response;
  },
};

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
Mews	`app`	`app`	This component uses the Mews app.
Reason	`reason`	`string`	Reason for updating the reservation. Required when updating the price of the reservation.
Reprice	`reprice`	`boolean`	Whether the price should be updated to latest value for date/rate/category combination set in Mews. If not specified, the reservation price is updated.
Apply Cancellation Fee	`applyCancellationFee`	`boolean`	Whether the cancellation fees should be applied according to rate cancellation policies. If not specified, the cancellation fees are applied.
Reservation ID	`reservationId`	`string`	Select a value from the drop down menu.
Channel Number	`channelNumber`	`string`	Number of the reservation within the Channel (i.e. OTA, GDS, CRS, etc) in case the reservation group originates there (e.g. Booking.com confirmation number)
Start UTC	`startUtc`	`string`	Reservation start in UTC timezone in ISO 8601 format
End UTC	`endUtc`	`string`	Reservation end in UTC timezone in ISO 8601 format
Released UTC	`releasedUtc`	`string`	Date when the optional reservation is released in UTC timezone in ISO 8601 format
Person Counts	`personCounts`	`string[]`	Number of people per age category the reservation is for. If supplied, the person counts will be replaced. Each item should contain: `AgeCategoryId` (string, required): Unique identifier of the Age category `Count` (integer, required): Number of people of a given age category. Only positive value is accepted Pass an array of person counts or null if the person counts should not be updated. Example: `[ { "AgeCategoryId": "12345678-1234-1234-1234-123456789012", "Count": 2 }, { "AgeCategoryId": "87654321-4321-4321-4321-210987654321", "Count": 1 } ]`
Assigned Resource ID	`assignedResourceId`	`string`	Identifier of the assigned Resource. If the assigned resource is locked, see AssignedResourceLocked for updating the assigned resource.
Requested Category ID	`requestedCategoryId`	`string`	Identifier of the requested ResourceCategory
Travel Agency ID	`travelAgencyId`	`string`	Select a value from the drop down menu.
Company ID	`companyId`	`string`	Select a value from the drop down menu.
Business Segment ID	`businessSegmentId`	`string`	Select a value from the drop down menu.
Purpose	`purpose`	`string`	Purpose of the reservation
Rate ID	`rateId`	`string`	Select a value from the drop down menu.
Credit Card ID	`creditCardId`	`string`	Select a value from the drop down menu.
Time Unit Prices	`timeUnitPrices`	`string[]`	Prices for time units of the reservation. Each unit should contain: `Index` (integer, required): Index of the unit starting with 0 (e.g., first night has index 0) `Amount` (object, optional): Amount parameters including: `GrossValue` (decimal, optional): Amount including tax (required for Gross Pricing environments) `NetValue` (decimal, optional): Amount excluding tax (required for Net Pricing environments) `Currency` (string, required): `ISO-4217` code of the currency `TaxCodes` (array of strings, required): Codes of tax rates to be applied (note: only one tax when using `GrossValue`, multiple taxes with `NetValue`) Pass an array of price units or null if the unit amounts should not be updated. Example: `[ { "Index": 0, "Amount": { "GrossValue": 100.00, "Currency": "EUR", "TaxCodes": ["VAT"] } }, { "Index": 1, "Amount": { "NetValue": 85.00, "Currency": "EUR", "TaxCodes": ["VAT", "CityTax"] } } ]`
Booker ID	`bookerId`	`string`	Select a value from the drop down menu.
Assigned Resource Locked	`assignedResourceLocked`	`boolean`	Whether the reservation should be locked to the assigned Resource. To reassign the reservation to a new Resource, first set AssignedResourceLocked to false to unlock the resource. Then, assign the reservation to a new Resource by setting AssignedResourceId to the new resource ID.
Availability Block ID	`availabilityBlockId`	`string`	Select a value from the drop down menu.
Options Owner Checked In	`optionsOwnerCheckedIn`	`boolean`	Whether the owner of the reservation has checked in.

Update Reservation with Mews API on New Interview Response from Async Interview API

Pipedream makes it easy to connect APIs for Mews, Async Interview and 2,800+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,800+apps by most popular

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