---
title: "Create a pickup request"
method: POST
path: "/pickup_requests"
tags: ["Pickup requests"]
---

# Create a pickup request

`POST /pickup_requests`

Creates a pickup request and processes the booking at the carrier.

## Request body

- CreatePickupRequestRequest
  - `carrier_code` 'fed_ex' | 'ups' | 'dhl_express' | 'geodis' | 'dhl_freight_se' | 'post_nord' | 'bring', required — Carrier code for the carrier the pickup should be requested for.
  - `pickup_address` object, required — Address where the shipments should be picked up from.
    - `company_name` string, required
    - `address1` string, required
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string, required
    - `city` string, required
    - `country_code` string, required
    - `contact_name` string, required — Name of the person that the carrier should contact about the pickup.
    - `contact_phone` string, required — Phone number of the person that the carrier should contact about the pickup.
  - `package_location` string, required — Where on the address the packages should be picked up.
  - `ready_by` string, date-time, required — When shipments are ready for pickup. Pickup date is taken from the date given here.
  - `closed_by` string, date-time, required — When shipments should be picked up by. The date part is ignored.
  - `shipment_ids` integer[], required — IDs of the shipments you wish to be picked up.
  - `is_residential` boolean — Only used for UPS. Whether the pickup address is residential or not.

## Response `200`

Successful.

## Other responses

- `401` — Unauthorized.
- `404` — Resource not found.
- `422` — Invalid or not found parameter(s)

---

[API](https://skmtc.net/shipmondo/apis/shipmondo-api.md) · [All operations](https://skmtc.net/shipmondo/apis/shipmondo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipmondo/shipmondo-api/revisions/3b9f91693dec/schema)