View as Markdown
Sendcloud icon

Sendcloud ACTION

List Service Points

List service points. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Sendcloud account once, then configure and run List Service Points 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: "sendcloud-list-service-points",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    sendcloud: { authProvisionId: "apn_xxxxxxx" },
    country: "country",
    accessToken: "Access Token",
  },
})

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.

List Service Points inputs
Property Type Description
country country string
Country of the recipient
Required
accessToken Access Token string
JWT containing user 'id' or 'iid' (integration ID), or a public API key.
Optional
address Address string
Destination address or postal code. Example: 'Stadhuisplein 10'
Optional
carrier Carrier Codes string
Comma-separated list of carrier codes. Example: 'postnl,dpd'
Optional
city City string
City of the recipient
Optional
generalShopType General Shop Type string[]
Single value or comma-separated values (e.g., 'servicepoint' or 'servicepoint,locker,post_office').
Optional
houseNumber House Number string
House number of the recipient
Optional
latitude Latitude string
Reference latitude for distance calculation.
Optional
longitude Longitude string
Reference longitude for distance calculation.
Optional
neLatitude NE Latitude string
Latitude of the northeast corner of the bounding box.
Optional
neLongitude NE Longitude string
Longitude of the northeast corner of the bounding box.
Optional
postalCode Postal Code string
Postal code of the destination. Example: '5611 EM'
Optional
pudoId PUDO ID string
DPD-specific parameter (<= 7 characters).
Optional
radius Radius (meters) integer
Radius (in meter) of a bounding circle. Can be used instead of the NE Latitude, NE Longitude, SW Latitude, and SW Longitude parameters to define a bounding box. Minimum value: 100 meters. Maximum value: 50 000 meters.
Optional
shopType Shop Type string
Filter results by shop type.
Optional
swLatitude SW Latitude string
Latitude of the southwest corner of the bounding box.
Optional
swLongitude SW Longitude string
Longitude of the southwest corner of the bounding box.
Optional
weight Weight (kg) string
Parcel weight in kilograms. Certain carriers have limits per service point.
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
sendcloud-list-service-points
Version
0.0.4
App
Sendcloud
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes