Create and Schedule a Courier Pickup — POST /pickups

Use this endpoint to schedule a courier pickup at your merchant’s location. You provide the date, expected order volume, and contact details — Now Shipping computes the pickup fee automatically. The response contains a pickupNumber you use in all subsequent get, update, cancel, and delete requests.

Never send pickupFees, fee, or amountOfFees in this request. Pickup fees are always computed server-side; any fee fields in the request body are silently ignored.

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.

Request body

number

required

Expected order count for this pickup. Used to compute the pickup fee — provide your best estimate.

string

required

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

string

required

Contact phone number for the courier. Must be an 11-digit Egyptian mobile number (e.g. 01012345678).

boolean

Set to true if any items in this pickup are fragile. Defaults to false.

boolean

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

string

Free-text notes passed to the courier (e.g. "Call before arrival", "Ring doorbell twice").

string

Override the pickup location text displayed to the courier. Defaults to your registered address.

string

Your merchant pickup address ID. When omitted, the pickup defaults to your main registered address.

Example request

curl -X POST "https://now.com.eg/api/public/v1/pickups" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY" \
  -H "X-Merchant-Id: shop_123" \
  -H "Content-Type: application/json" \
  -d '{
    "numberOfOrders": 15,
    "pickupDate": "2026-07-28",
    "phoneNumber": "01012345678",
    "isFragileItems": false,
    "isLargeItems": false,
    "pickupNotes": "Call before arrival"
  }'

Response

A successful request returns HTTP 201 with the full pickup object.

boolean

true on success.

object

Show pickup fields

string

MongoDB _id of the created pickup record.

string

6-digit pickup number. Use this value in all subsequent get, update, cancel, and delete requests.

string

The scheduled pickup date in YYYY-MM-DD format.

string

Current pickup status (e.g. new). Note: the field name is picikupStatus (as returned by the API).

string

Status category for grouping (e.g. new).

string

Human-readable status label (e.g. "New").

number

The expected order count you submitted.

number

Server-computed pickup fee in EGP. This value is authoritative — do not send it back in update requests.

string

The contact phone number on record for this pickup.

string

The pickup location text displayed to the courier.

string

The linked merchant pickup address ID.

boolean

Whether fragile items were flagged.

boolean

Whether large items were flagged.

string

Courier notes attached to this pickup.

string

ISO 8601 timestamp of when the pickup was created.

string

ISO 8601 timestamp of the most recent update.

{
  "success": true,
  "data": {
    "pickup": {
      "pickupId": "66f1a2b3c4d5e6f7a8b9c0d3",
      "pickupNumber": "482917",
      "pickupDate": "2026-07-28",
      "picikupStatus": "new",
      "statusCategory": "new",
      "statusLabel": "New",
      "numberOfOrders": 15,
      "pickupFees": 50,
      "phoneNumber": "01012345678",
      "pickupLocation": "12 Street, Building 4, Cairo",
      "pickupAddressId": "66f1a2b3c4d5e6f7a8b9c0d4",
      "isFragileItems": false,
      "isLargeItems": false,
      "pickupNotes": "Call before arrival",
      "createdAt": "2026-07-26T12:00:00.000Z",
      "updatedAt": "2026-07-26T12:00:00.000Z"
    }
  }
}

Response field reference

Field	Type	Description
`pickup.pickupId`	string	MongoDB `_id` — internal record identifier
`pickup.pickupNumber`	string	6-digit pickup number — use for get/update/cancel/delete
`pickup.pickupDate`	string	Scheduled pickup date
`pickup.picikupStatus`	string	Current status (e.g. `new`)
`pickup.pickupFees`	number	Server-computed fee in EGP
`pickup.numberOfOrders`	number	Expected order count as submitted

Save the pickupNumber from the response — it is the primary identifier for all follow-up operations. If you need to preview the fee before calling this endpoint, use POST /pickups/calculate-fee first.

System

Merchants

Fees

Orders

Pickups

Reference

Create and Schedule a Courier Pickup — POST /pickups

Authentication

Request body

Example request

Response

Response field reference

​Authentication

​Request body

​Example request

​Response

​Response field reference

Authentication

Request body

Example request

Response

Response field reference