post
https://api.envia.com/ship/pickup/
Arrange carrier pickups for your shipments at a specified address and time.
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.