Skip to main content
Go to nevuto.com

Connect EasyPost to Nevuto

Published May 22, 20267 min read

What is EasyPost?

EasyPost is a US-based multi-carrier shipping aggregator. A single API gives you access to USPS, UPS, FedEx, DHL Express, OnTrac, and 100+ carriers for both domestic US and international shipments. It's optimized for US domestic flows, but international delivery is fully supported.

How Nevuto handles EasyPost

  • You paste one API key; Nevuto sets up the webhook connection automatically.
  • New EasyPost accounts go through anti-fraud manual review — we surface this up front.
  • Live cheapest-rate selection on every shipment, filtered by your preferred carriers.
  • All webhooks arrive signed and Nevuto verifies the signature for you.
  • Both Test Key and Production Key are supported; flip Test mode with a single toggle.

1. Prerequisites

  • An active EasyPost account. If you don't have one yet, sign up at easypost.com.
    • ⚠️ EasyPost runs anti-fraud manual review on new accounts. Within 1-3 business days of signup you'll get an email asking for ID verification and business details. The API key tab can stay hidden until your account is activated.
  • At least one carrier account must be connected inside EasyPost. The free tier ships with a default USPS test account; in production you can bring your own USPS/UPS/FedEx contracts.
  • Your store currency must be USD — EasyPost is USD-only.
  • Your sender address country should be US (most common); other countries are limited.
  • You must fund the EasyPost Wallet (the label cost is debited per shipment). Settings → Billing.

2. EasyPost API key

  1. Sign in to the EasyPost dashboard.
  2. Account Settings → API Keys (https://app.easypost.com/account/settings?tab=api-keys).
  3. Copy your Test Key or Production Key.
  4. If your account isn't active yet, the "API Keys" tab can come up empty. That means anti-fraud review is still pending; reply to the signup email or contact support.

⚠️ A test key prints test labels (no charge). A production key prints real carrier labels and debits your wallet.

3. Connecting in Nevuto

  1. Open your Nevuto admin panel and go to Settings → Shipping → Shipping providers.
  2. Pick EasyPost from the list.
  3. Paste your EasyPost token into the API key field.
  4. Turn on the Enable shipping method toggle.
  5. (Optional) Test mode toggle: enable it if you're using a Test key.
  6. Click Submit.

When you submit, Nevuto:

  • Stores the API key securely
  • Sets up the webhook connection automatically on your EasyPost account — no manual step
  • Receives every webhook signed; Nevuto verifies authenticity for you

4. Preferred carrier accounts

Once you've saved, a Settings card opens below:

  1. Pick one or more carrier account IDs from the Preferred carriers dropdown.
  2. The dropdown is pulled live from your EasyPost account — you'll only see carriers that are active on your account.
  3. Submit.

Behavior:

  • When an order ships, Nevuto pulls the EasyPost rate list, filters by your preferred carriers, and buys the cheapest rate.
  • If you've set no preference, Nevuto picks the cheapest across all active carriers.

💡 Carriers show up in the dropdown with their readable names (USPS, UPS, FedEx, etc.).

5. Sender address

EasyPost uses your sender address on every shipment. Nevuto pulls it from your default store location:

  1. Settings → Locations.
  2. Fill in your default location as a US address:
    • Street, City, State (short code: CA, NY), ZIP, Country (US), Phone

⚠️ We recommend entering the phone number in international format: +12125551234. Local format is accepted too, but international is the safest bet.

6. Shipping packages

EasyPost asks for package dimensions on every shipment. Nevuto resolves them in this order:

  1. Variant LWH info
  2. ShippingPackage reference
  3. Store default package
  4. Fallback: 12×9×1 inch (USPS Flat Rate Envelope)

Steps:

  1. Go to Settings → Shipping → Packages.
  2. Add package → Name, Type, L/W/H/unit, weight.
  3. Set as default.

7. Variant LWH

Enter real dimensions and weight on each variant:

  1. Products → edit product → Variants.
  2. Length / Width / Height / Weight.
  3. Units: cm/in, weight: g/kg/oz/lb.

💡 The US default is in (inch) and oz (ounce). EasyPost accepts both; Nevuto converts automatically.

8. Customs declaration (international)

For shipments from US to other countries Nevuto adds a customs declaration automatically:

  • Items: order lines (product description, qty, weight, value, country of origin)
  • US customs requirements: required exemption flags are added automatically
  • Currency: USD
  • Contents type: merchandise
  • Non-delivery option: return (returned if undeliverable)

HS code: Nevuto doesn't store this per-product → it's sent empty. You can fill it in manually inside the EasyPost panel.

9. Shipping an order

Once the customer has paid, the order shows up in your admin panel ready for the "Mark as shipped" button.

  1. Open the order detail page.
  2. Click Mark as shipped.
  3. In the modal that opens, choose EasyPost as the provider and hit Submit.
  4. Within seconds the order line shows a tracking number, a tracking link, and a "Print label" button. At the same moment your EasyPost wallet is debited for the label.
  5. Click Print label to open the label as a PDF, print it, and stick it on the parcel.
  6. Hand the parcel over to your preferred carrier — the rest is tracked automatically.

💡 The customer can track the shipment from their own order page via the tracking link, and receives email updates as the status changes.

10. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Label printed, carrier hasn't picked up yet
    │
    ▼   When the carrier scans the package
[shipping_status: SHIPPED]         ← EasyPost webhook fires (tracker.updated)
    │
    ▼   Delivered to the customer
[shipping_status: DELIVERED]       ← Webhook

EasyPost status mapping (Nevuto):

  • En route, in transit, out for delivery → Shipped
  • Delivered, available for pickup → Delivered
  • Return, failure, cancel → ignored

The webhook connection is set up automatically during onboarding and every notification is signature-verified — no manual upkeep needed.

11. Test mode

EasyPost has a real test environment:

  1. EasyPost dashboard → API Keys → copy your Test Key.
  2. In Nevuto admin → Settings → Shipping → EasyPost → paste the test key into the API key field and turn on the Test mode toggle.
  3. Submit.
  4. Test shipments will:
    • Return a tracking number (format EZ100…)
    • Produce a PDF label (stamped as test)
    • Not debit your wallet
    • Send test notifications
  5. Before going live, turn Test mode off and switch to your Live key.

12. Common issues

A. "We need a bit more information about your account" email

  • EasyPost runs manual review on new accounts. Answer the questions in the email and complete the Stripe ID verification link; within 1-3 business days your account is activated.

B. The API key tab isn't showing

  • The account isn't activated yet (see A above). Or you picked "Personal" as account type but business details are being requested.

C. No balance in the wallet, I can't print labels

  • EasyPost dashboard → Account → Billing → Add funds to top up your wallet. Test mode doesn't debit anything.

D. "Customs declaration is required for international" error

  • International shipments need customs info. Double-check that the customer address has the country field filled in correctly.

E. State name rejected

  • EasyPost requires a short state code: CA, NY. The full name (California) is rejected. Enter the state as a short code in Settings → Locations.

F. Not showing up in the provider list

  • If your store currency isn't USD you'll see a "Not available in your store currency" warning.
  • If your store address country isn't US you'll see a "Doesn't ship from your shop location" warning.

G. No webhook arriving / "Unauthorized" error

  • If you've rotated the API key, hit Submit again in Nevuto admin — the webhook connection is re-established and the signing key is refreshed.

13. Next steps

  • Once EasyPost anti-fraud approval comes through, connect with your API key and run a small test shipment
  • Enter HS codes once per product inside the EasyPost panel — critical for international orders
  • Add a margin to your shipping rates

Help

Related articles