Update a Scheduled Pickup — PUT /pickups/{pickupNumber}

Use this endpoint to modify a pickup that has not yet been picked up by a courier. You can update the scheduled date, order count, contact phone, item flags, notes, and pickup address. Pickup fees are recomputed automatically on every successful update — you do not need to calculate or send them.

Updates are only allowed while the pickup is in new or pendingPickup status. Past these states the pickup is locked and any modification attempt will return an error.

Authentication

All requests require a valid API key. Company account keys must also include the X-Merchant-Id header.

Authorization: Bearer nsk_live_YOUR_KEY
X-Merchant-Id: shop_123

X-Merchant-Id accepts your businessAccountCode (8-digit), externalMerchantId, or MongoDB _id. Single-business keys do not require this header.

Path parameter

string

required

The 6-digit pickup number returned when the pickup was created (e.g. 482917).

Request body

Send the same fields you would use when creating a pickup. Only include the fields you want to change — unset fields retain their current values.

number

Updated expected order count. Triggers a fee recalculation.

string

New scheduled pickup date in YYYY-MM-DD format. Must be a valid future date per the Now Shipping pickup date policy.

string

Updated courier contact phone number. Must be an 11-digit Egyptian mobile number.

boolean

Set to true if any items are fragile. Defaults to false.

boolean

Set to true if any items are large or oversized. Defaults to false.

string

Updated free-text notes for the courier.

string

Override the pickup location text displayed to the courier.

string

Change the linked merchant pickup address ID.

Example request

curl -X PUT "https://now.com.eg/api/public/v1/pickups/482917" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "X-Merchant-Id: shop_123" \
  -H "Content-Type: application/json" \
  -d '{
    "numberOfOrders": 20,
    "pickupDate": "2026-07-29",
    "phoneNumber": "01012345678",
    "pickupNotes": "Updated notes"
  }'

Response

A successful request returns HTTP 200 with the updated pickup object. The pickupFees field in the response reflects the newly recomputed fee.

boolean

true on success.

object

Show pickup fields

string

MongoDB _id of the pickup record.

string

6-digit pickup number (unchanged).

string

Updated scheduled date.

string

Current pickup status string. Note: the field name is picikupStatus as returned by the API.

number

Recomputed pickup fee in EGP reflecting the latest numberOfOrders and address configuration.

number

Updated expected order count.

string

ISO 8601 timestamp of this update.

{
  "success": true,
  "data": {
    "pickup": {
      "pickupId": "66f1a2b3c4d5e6f7a8b9c0d3",
      "pickupNumber": "482917",
      "pickupDate": "2026-07-29",
      "picikupStatus": "new",
      "statusCategory": "new",
      "statusLabel": "New",
      "numberOfOrders": 20,
      "pickupFees": 60,
      "phoneNumber": "01012345678",
      "isFragileItems": false,
      "isLargeItems": false,
      "pickupNotes": "Updated notes",
      "createdAt": "2026-07-26T12:00:00.000Z",
      "updatedAt": "2026-07-26T14:30:00.000Z"
    }
  }
}

Error responses

HTTP status	Error code	Description
`400`	`VALIDATION_ERROR`	Invalid field value (e.g. past date, missing required field).
`403`	`FORBIDDEN`	Pickup is no longer in an editable status.
`404`	`NOT_FOUND`	No pickup with this `pickupNumber` found under your account.
`401`	`UNAUTHORIZED`	Missing or invalid API key.
`403`	`MERCHANT_REQUIRED`	Company key used without `X-Merchant-Id`.

If you need to check the current status of a pickup before attempting an update, call GET /pickups/{pickupNumber} first. Only new and pendingPickup statuses allow modifications.

System

Merchants

Fees

Orders

Pickups

Reference

Update a Scheduled Pickup — PUT /pickups/{pickupNumber}

Authentication

Path parameter

Request body

Example request

Response

Error responses

​Authentication

​Path parameter

​Request body

​Example request

​Response

​Error responses

Authentication

Path parameter

Request body

Example request

Response

Error responses