---
title: "Book a pickup for booked shipments"
method: POST
path: "/shipments/pickups"
tags: ["shipments"]
---

# Book a pickup for booked shipments

`POST /shipments/pickups`

ADD ENDPOINT DESCRIPTION HERE

## Request body

- PickupsPostRequest
  - `sellerId` integer, required — Required seller for which to book the pickup.
  - `shippingServiceGroupId` integer, required — Required shipping service group for which to book the pickup.
  - `parcelCount` integer, required — Required count of parcels which need to be picked up.
  - `pickupDate` string, date, required — Required day when the booked shipments should be picked up.
  - `pickupFrom` ShipmentAddress
    - `name` string — Name of the recipient. <br>Usually this is the first and lastname of the recipient.
    - `company` string — Name of the company.
    - `phone` string — Phone number of the recipient. <br>The phone number is usually optional.
    - `email` string — E-Mail address of the recipient.
    - `zip` string — ZIP Code of the recipient <br>The ZIP code is optional for some countries, but required for most.
    - `city` string, required — City of the recipient. <br>The city should always be specified.
    - `state` string — State of the recipient. <br>This is not required for most countries, but required in some (eg: United States).
    - `countryIso2` string
    - `street` string, required — Street (or Address Line 1) of the recipient. <br>This field should always be specified.
    - `street2` string — Street (or Address Line 2) of the recipient. <br>This field is optional.

## Response `default`

successful operation

---

[API](https://skmtc.net/writechoiceorg/apis/connector.md) · [All operations](https://skmtc.net/writechoiceorg/apis/connector/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/writechoiceorg/connector/versions/7ce09a4b2a4e/schema)