# UPS + Krokul CRM

Yes. Krokul CRM integrates with UPS. A manager compares UPS services and prices on the deal, creates the shipment with a label and a tracking number, and Krokul follows the package through UPS Track Alert events until it is delivered. Exceptions and delivery reach the deal feed without anyone checking the UPS site.

**Status:** Via API and webhooks. **Automation platforms:** n8n.

## What your team gets

### Pick a service with the price in front of you

Before shipping, Krokul calls the UPS Rating API with the request option Shoptimeintransit. UPS answers with every available service from the ship-from to the ship-to address, with the rate and transit time for each. The manager picks one on the deal and can add the cost as a line on the invoice.

### Label and tracking number from the deal

Krokul sends the recipient from the deal contact, the client company address and the package weight to the UPS Shipping API. UPS returns the shipment identification number, a tracking number for each package and the label image. The label opens for printing from the shipment on the deal, and the tracking number lands in the deal feed.

### Delivery status without polling

Right after the label is created, Krokul subscribes the tracking number through UPS Track Alert. UPS then posts a TrackingEvent to Krokul for each scan. The activityStatus type I marks the package as on the way, and type D with actualDeliveryDate closes the shipment as delivered.

### Exceptions turn into tasks

An activityStatus of type X tells Krokul that UPS logged a package exception. Krokul creates a task for the deal owner with the status description and location from the event. A U event with a new scheduledDeliveryDate updates the expected date on the shipment so the client gets a correct answer.

### Cancel a shipment that should not go

If the order changes before pickup, the manager cancels the shipment from the deal. Krokul calls the UPS void endpoint with the shipment identification number and marks the shipment as cancelled.

## What moves between UPS and Krokul

| UPS | Krokul | Direction | When |
|---|---|---|---|
| Address Validation | Client company address | Krokul → UPS | Before the first shipment to a new address |
| Rating (Shop, Shoptimeintransit) | Service and price choice on the deal | UPS → Krokul | The manager prepares a shipment |
| Shipment (ship request) | Recipient, address, packages from the deal | Krokul → UPS | The manager creates the shipment |
| ShipmentIdentificationNumber, tracking number, label | Shipment on the deal, deal feed | UPS → Krokul | Right after the shipment is created |
| Track Alert subscription | Tracking number of the shipment | Krokul → UPS | Right after the label is created |
| TrackingEvent (activityStatus I, U, D) | Shipment status and expected date | UPS → Krokul | Each UPS scan |
| TrackingEvent (activityStatus X) | Task for the deal owner | UPS → Krokul | UPS logs an exception |
| Void shipment | Cancelled shipment | Krokul → UPS | The manager cancels before pickup |

## How to connect today

### Krokul app in n8n

1. Install the verified UPS node in n8n and connect it with your UPS Client ID and Client Secret. Connect the Krokul app with a Krokul API key.
2. Start from the Krokul trigger Deal Stage Changed, filtered on your shipping stage.
3. Use the UPS node operations Validate and Get Rates for the address and price, then Create to make the shipment.
4. Write the tracking number back to the deal with the Krokul action Add Activity, and run Track on a schedule for open shipments.

### Custom flow through the Krokul API and webhooks

1. Issue a Krokul API key with scopes for deals, contacts, activities and tasks. Create a UPS app on the developer portal and get an OAuth token with client credentials.
2. Subscribe a Krokul webhook to card.statusChanged with a statusUuid filter for your shipping stage and verify x-crm-signature.
3. Call the UPS Shipping API, save the shipment identification number on the deal with externalRef/api-set and log the tracking number with activity/api-create.
4. Subscribe the tracking number in UPS Track Alert and, on each TrackingEvent, update the deal or open a task with task/api-create.

**Actions:** Validate; Get Rates; Create; Track.

### For integrators

UPS publishes OpenAPI files for Shipping, Rating, Tracking, Track Alert, Address Validation and Paperless Documents on GitHub, with a separate Customer Integration Environment for tests. Access uses OAuth, either client credentials for your own account or an authorization code flow for a shipper who connects an account to your app. On the Krokul side, the UPS shipment number is kept as an externalRef on the deal, and signed Krokul webhooks carry the stage change that starts the shipment.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul integrate with UPS?

Yes. Krokul compares UPS rates, creates shipments with labels and tracking numbers from a deal, and updates the delivery status from UPS Track Alert events.

### How does Krokul learn that a UPS package was delivered?

Through a UPS Track Alert webhook. UPS posts a TrackingEvent with activityStatus type D and actualDeliveryDate, and Krokul marks the shipment on the deal as delivered.

### Can a manager see UPS prices before creating a label?

Yes. The UPS Rating API with the Shop or Shoptimeintransit option returns rates for all UPS services between the two addresses, with transit times for the second option.

### Which UPS credentials does Krokul need?

A Client ID and Client Secret from an app on the UPS developer portal, plus your 6-digit UPS account number for billing the shipment.

## Limits

Pickups, billing and claims stay in your UPS account. UPS Track Alert accepts up to 100 tracking numbers per subscription request, and UPS documents only the en_US locale for it.

## Related services

- [DHL Express](https://krokul.com/en/integrations/dhl-express/index.md)
- [ShipStation](https://krokul.com/en/integrations/shipstation/index.md)
- [Shopify](https://krokul.com/en/integrations/shopify/index.md)
- [WooCommerce](https://krokul.com/en/integrations/woocommerce/index.md)

[Shipping and logistics](https://krokul.com/en/integrations/category/shipping/index.md)

UPS is a trademark of United Parcel Service of America, Inc. Krokul is not affiliated with UPS.

Updated: 2026-10-15

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs