Pickups
You can schedule a carrier pickup to have your parcels collected by a delivery driver. When you schedule a pickup via the Sendcloud API, the sender address is dynamic, which means that you can request the pickup to take place at an address of your choice.
You can only schedule a one-time (incidental) pickup via the API. If you ship large volumes of orders every week and would like to schedule a recurring pickup on a weekly or bi-weekly basis, you can contact your sales representative to arrange this on your behalf.
How to schedule a pickup
Pickups can be scheduled by making a POST request to the Create a pickup endpoint. You can specify a time window for the pickup to take place when you make the request.
Example request
POST
https://panel.sendcloud.sc/api/v2/pickups
1curl --location -g --request POST 'https://panel.sendcloud.sc/api/v2/pickups' \
2--header 'Authorization: Basic <credentials>' \
3--data-raw '
4{
5 "city": "Eindhoven",
6 "company_name": "Sendcloud",
7 "name": "John Doe",
8 "country": "NL",
9 "email": "example@sendcloud.com",
10 "address": "Stadhuisplein 10",
11 "address_2": "",
12 "pickup_from": "2022-04-06T12:00:00Z",
13 "pickup_until": "2022-04-06T17:00:00Z",
14 "postal_code": "5611 EM",
15 "quantity": 20,
16 "telephone": "0612345678",
17 "total_weight": "1",
18 "carrier": "dhl_express"
19}'
Example response
1{
2 "id": 1,
3 "city": "Eindhoven",
4 "country": "NL",
5 "address": "Stadhuisplein 10",
6 "pickup_from": "2022-04-06T12:00:00Z",
7 "postal_code": "5611 EM",
8 "quantity": 20,
9 "company_name": "Sendcloud",
10 "name": "John Doe",
11 "email": "example@sendcloud.com",
12 "address_2": "",
13 "pickup_until": "2022-04-06T17:00:00Z",
14 "reference": "",
15 "special_instructions": "",
16 "telephone": "0612345678",
17 "total_weight": "1.00",
18 "tracking_number": "",
19 "pickup_status": "Announcing",
20 "created_at": "2022-03-30T09:20:37.957495Z",
21 "cancelled_at": null,
22 "carrier": "dhl_express"
23}