View as Markdown
Mews icon

Mews ACTION

Create Reservation

Create a reservation in Mews. See reservation parameters in the docs. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mews account once, then configure and run Create Reservation from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mews-create-reservation",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mews: { authProvisionId: "apn_xxxxxxx" },
    serviceId: "Service ID",
    startUtc: "Start (UTC)",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Reservation inputs
Property Type Description
serviceId Service ID string
Identifier of the Service (bookable service). See the documentation
Required Dynamic
startUtc Start (UTC) string
Start of the reservation in ISO 8601 (UTC). Eg. 2025-01-01T00:00:00Z
Required
endUtc End (UTC) string
End of the reservation in ISO 8601 (UTC). Eg. 2025-01-01T00:00:00Z
Required
personCounts Person Counts string[]

Number of people per age category the reservation was booked for. At least one category with valid count must be provided.

Parameters:

  • 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

Example:

[
  {
    "AgeCategoryId": "3ed9e2f3-4bba-4df6-8d41-ab1400b21942",
    "Count": 2
  },
  {
    "AgeCategoryId": "ab7e1cf3-5fda-4cd2-8f41-ab1400b21943",
    "Count": 1
  }
]
Required
customerId Customer ID string
Identifier of the Customer who owns the reservation. See the documentation
Required Dynamic
requestedCategoryId Requested Category ID string
The category of the resource requested for the reservation.
Required Dynamic
rateId Rate ID string
Identifier of the Rate. See the documentation
Required Dynamic
state State string
State of the reservation.
Optional
channelNumber Channel Number string
The number of the channel that made the reservation.
Optional
notes Notes string
Notes of the reservation.
Optional
companyId Company ID string
Identifier of the Company. See the documentation
Optional Dynamic
travelAgencyId Travel Agency ID string
Identifier of the Travel Agency. (Company with a TravelAgencyContract)
Optional Dynamic
businessSegmentId Business Segment ID string
Identifier of the Business Segment. See the documentation
Optional Dynamic
additionalFields Additional Fields object
Raw payload fields to include in the request (e.g. filters).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mews-create-reservation
Version
0.0.4
App
Mews
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes