# 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:

```json
"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.

```json title="POST /{{tenant_id}}/deliveries — Customer Pickup"
{
    "store_id": "{{store_id}}",
    "delivery_mode": "customer_pickup",
    "delivery_type": "fast",
    "address": {
        "name": "Customer Name",
        "address": "42 Customer Street",
        "city": "Fitzroy",
        "state": "VIC",
        "post_code": "3065",
        "country": "AU"
    },
    "customer": {
        "first_name": "Customer",
        "last_name": "Name",
        "phone": "0400000000",
        "email": "customer@email.com"
    },
    "parcels": [
        {
            "reference": "PARCEL_001",
            "weight_kg": 1.0,
            "length_cm": 20,
            "width_cm": 15,
            "height_cm": 10,
            "quantity": 1
        }
    ]
}
```

***

## Address Handling

The address direction is flipped under `customer_pickup`:

| Field      | Standard delivery               | Customer pickup              |
| ---------- | ------------------------------- | ---------------------------- |
| `address`  | Delivery destination (customer) | Pickup origin (customer)     |
| `store_id` | Pickup origin (store)           | Delivery destination (store) |

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.