> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# UPS

> Create UPS shipping and return labels, track parcels and book pickups from the ticket

UPS is the parcel carrier many MSPs use to send laptops and other hardware to their customers' users, and to get them back when someone leaves. Connect your own UPS account once, and Neo agents can create the labels, put the tracking number and label link on the ticket, and follow the parcel until it arrives.

## What Neo can do with UPS

* Create a shipping label to send a laptop to a user, with a link the technician prints
* Create a return label for a user who leaves: UPS emails it to the user, or the technician prints it
* Track a parcel by tracking or reference number, and note on the ticket when it is delivered or held up
* Void a label that was not used, so UPS does not bill it
* Check a US address, compare services and transit times, and book or cancel a pickup
* Change a parcel on its way (redirect, hold for collection, return to sender) and read the fee first
* Quote duties and check customs requirements for an international shipment

## Get a laptop back

On an offboarding ticket, Neo reads the user's address and personal email from the ticket or your PSA, creates a UPS Electronic Return Label, and UPS emails the label to the user. Neo adds a private note to the ticket with the tracking number. A scheduled agent can then check the tracking number each day and note on the ticket when the laptop is delivered.

## Send a laptop to a user

On an onboarding or replacement ticket, Neo checks the user's address, creates the shipment from your office to the user, and puts the label's print link and the tracking number on the ticket for the technician who packs the laptop.

## What your agent needs to know

UPS needs the address you ship from, and the size and weight of the box. Put them in your agent's instructions, for example: "We ship from 100 Main St, Springfield, IL 62701, phone 217 555 0100. A laptop box is 18 x 14 x 4 inches and weighs 6 lb. Use UPS Ground unless the ticket asks for faster." Without them, Neo asks the technician before it creates a label.

See [UPS API](https://docs.neoagent.io/agents/tools/management/ups-api.md) for the permission groups.

## Next steps

> [card] [Connect UPS](https://docs.neoagent.io/integrations/ups/connecting-to-neo.md)
>
> Create an app in the UPS Developer Portal and save its keys in Neo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.