Customer Pickup

A customer pickup delivery is a reverse-direction shipment where a driver collects from the customer’s address and delivers to the store. It is created using the standard delivery endpoint with delivery_mode: "customer_pickup" in the request body.

Endpoint

POST {{domain}}/{{tenant_id}}/deliveries

Authentication: Bearer token required via the Authorization header.

Prerequisites

Customer pickup must be enabled before it can be used.

Brand/store level — the store must have customer_pickup enabled:

1
"supported_modes": ["store_to_door", "customer_pickup"]

Contact your Rendr implementation partner to confirm this is configured for your account before attempting customer pickup deliveries.

Request Payload

Set delivery_mode: "customer_pickup" in the request body. All other standard delivery fields apply.

1
{
2
    "store_id": "{{store_id}}",
3
    "delivery_mode": "customer_pickup",
4
    "delivery_type": "fast",
5
    "address": {
6
        "name": "Customer Name",
7
        "address": "42 Customer Street",
8
        "city": "Fitzroy",
9
        "state": "VIC",
10
        "post_code": "3065",
11
        "country": "AU"
12
    },
13
    "customer": {
14
        "first_name": "Customer",
15
        "last_name": "Name",
16
        "phone": "0400000000",
17
        "email": "customer@email.com"
18
    },
19
    "parcels": [
20
        {
21
            "reference": "PARCEL_001",
22
            "weight_kg": 1.0,
23
            "length_cm": 20,
24
            "width_cm": 15,
25
            "height_cm": 10,
26
            "quantity": 1
27
        }
28
    ]
29
}

Address Handling

The address direction is flipped under customer_pickup:

Rendr handles the address inversion automatically when passing the shipment to the carrier. You do not need to manually reverse anything in the payload.

Response

The response follows the standard delivery creation structure. The delivery record will include "delivery_mode": "customer_pickup", which is used by the Workbench portal, tracking page, webhooks, and other downstream systems to differentiate it from a standard outbound delivery.