MyParcel

🔑 BYO Key — Shipping

NL shipping platform (PostNL, DPD, DHL, bpost, UPS, GLS). Create shipments, print labels, track packages, and offer delivery options at checkout.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

myparcel_api_key

API Key

Generate at backoffice.myparcel.nl → Settings → API Keys. Store the raw key — the engine handles base64 encoding.

Get your API key at myparcel.nl →

Endpoints (8)

POST create-shipment

Create one or more shipments. Body must contain data.shipments array. Each shipment needs: recipient (cc, city, street, number, postal_code, person), options (package_type), and carrier. Returns shipment IDs. Carrier IDs: 1=PostNL, 2=bpost, 4=DPD, 9=DHL. Package types: 1=package, 2=mailbox, 3=letter, 4=digital_stamp, 6=small_package.

Field	Type	Required	Description
`data`	array	✓ Yes	Wrapper object. Must contain "shipments" array with shipment objects. Each shipment: recipient (cc, city, street, number, postal_code, person, email, phone), options (package_type, signature, only_recipient, insurance, return, label_description, large_format, age_check), carrier (1=PostNL, 2=bpost, 4=DPD, 9=DHL For You, 10=DHL Parcel Connect, 12=UPS). Optional: reference_identifier, physical_properties (weight), pickup (for delivery_type 4).

GET get-shipment

Retrieve details of a specific shipment by ID. Returns shipment with status, barcode, recipient, sender, options, and timestamps.

Field	Type	Required	Description
`shipment_id`	string	✓ Yes	MyParcel shipment ID (numeric)

GET list-shipments

List and search shipments. Supports filtering by status (1=concept, 2=registered, 3=handed to carrier, 7=delivered), search query, date range, and pagination.

Field	Type	Required	Description
`q`	string	No	Search query — searches across all shipment fields including recipient name, address, reference
`status`	string	No	Filter by shipment status. Semicolon-separated for multiple: "1" (concept), "2" (registered), "3" (handed to carrier), "7" (delivered). Example: "2;3"
`reference_identifier`	string	No	Filter by your custom reference identifier
`from`	string	No	Filter from date (YYYY-MM-DD)
`to`	string	No	Filter to date (YYYY-MM-DD)
`page`	integer	No	Page number (1-1000, default 1)
`size`	integer	No	Items per page (30-200, default 30)

DELETE delete-shipment

Delete a shipment. Only possible for concept shipments (status 1 — no label generated yet). Returns 204 No Content on success.

Field	Type	Required	Description
`shipment_id`	string	✓ Yes	MyParcel shipment ID to delete (must be status 1 / concept)

GET get-label

Get shipment label as a PDF download link. Supports A4 (4 labels/page) and A6 (1 label/page) format. For A4, you can specify label positions (1=top-left, 2=top-right, 3=bottom-left, 4=bottom-right). Multiple shipment IDs can be semicolon-separated.

Field	Type	Required	Description
`shipment_id`	string	✓ Yes	MyParcel shipment ID(s). For multiple labels: "123;456;789"
`format`	string	No	Paper size: "A4" (4 labels/page) or "A6" (1 label/page). Default: A6
`positions`	string	No	Label position(s) on A4 sheet: "1" (top-left), "2" (top-right), "3" (bottom-left), "4" (bottom-right). Semicolon-separated: "1;2"

GET track-shipment

Get track & trace information for a shipment. Returns current status, full history with timestamps and locations, tracking links, and estimated delivery moment. Status codes: 1=concept, 2=registered, 3=handed to carrier, 4=sorting, 5=distribution, 6=customs, 7=delivered.

Field	Type	Required	Description
`shipment_id`	string	✓ Yes	MyParcel shipment ID(s). For multiple: "123;456"

GET delivery-options

Get available delivery options for a specific address. Returns delivery types (morning, standard, evening, pickup) with available dates and time slots. Used in the checkout flow to let customers choose their preferred delivery option.

Field	Type	Required	Description
`cc`	string	✓ Yes	Country code (ISO 3166-1 alpha-2), e.g. "NL", "BE"
`postal_code`	string	✓ Yes	Postal code of the delivery address
`number`	string	✓ Yes	House number
`carrier`	integer	No	Carrier ID (1=PostNL, 2=bpost, 4=DPD, 9=DHL). Default: 1 (PostNL)
`platform`	integer	No	Platform: 1=myparcel (NL), 2=flespakket, 3=belgie. Default: 1
`cutoff_time`	string	No	Cut-off time for same-day processing (HH:MM format, e.g. "16:00")

GET drop-off-points

Find nearby drop-off and pickup points (PostNL, DPD, DHL locations). Returns locations with address, opening hours, and distance. Used in checkout for pickup delivery type.

Field	Type	Required	Description
`postal_code`	string	✓ Yes	Postal code to search near
`cc`	string	✓ Yes	Country code (ISO 3166-1 alpha-2), e.g. "NL", "BE"
`carrier`	integer	No	Carrier ID (1=PostNL, 2=bpost, 4=DPD). Default: 1 (PostNL)

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
create-shipment	`myparcel_create_shipment`
get-shipment	`myparcel_get_shipment`
list-shipments	`myparcel_list_shipments`
delete-shipment	`myparcel_delete_shipment`
get-label	`myparcel_get_label`
track-shipment	`myparcel_track_shipment`
delivery-options	`myparcel_delivery_options`
drop-off-points	`myparcel_drop_off_points`

← Back to all integrations