Schedules a carrier pickup at a specified address and time. Provide the pickup address, carrier, date/time window, and tracking numbers, and Envia will coordinate the pickup and return a confirmation.

Use Case

Use this endpoint after you've created shipping labels and your packages are ready for hand ‑off. It's ideal for merchants or customers who prefer carriers to collect packages from their location instead of dropping them off. Schedule pickups from homes, offices, or warehouses and receive immediate confirmation and status updates.

Required Inputs

Carrier: Name of the carrier that will perform the pickup (e.g. UPS, FedEx, DHL).
Pickup address: Contact name, company, phone, email, street, city, state, postal code, and other address details.
Date and time window: When the pickup should occur (some carriers require a range of hours).
Tracking numbers: List of shipment tracking numbers to be collected.

Notes

Only one pickup request per carrier is allowed.
Address requirements differ by country (e.g., Colombia may need additional locality or department fields); check the examples for proper formatting.
Pickup availability and same‑day cut-off times depend on the carrier and region.