How hard is it to migrate from EasyPost to GoatLabels?

For most teams it is a few days of work, because the concepts line up one to one: create a shipment, read rates, buy the chosen rate, void when needed, and receive tracking webhooks. You remap those calls to the GoatLabels REST endpoints, swap the Bearer token, re-point and re-verify the webhook, and keep the surrounding business logic exactly as it is.

What is the recommended migration order?

Rates first, because it is read-only and free — run it in parallel and diff the prices against what you pay now. Then buy, behind a feature flag on a slice of traffic. Then void and webhooks, since they follow the shipments the new path created. Cut the remaining traffic over once a week of real orders looks right.

Do I need to change my retry logic?

No, and you should keep it. Writes accept an idempotency key, so a retried purchase returns the original label rather than buying a second one. Because calls are unlimited and free, aggressive retries cost nothing beyond the label itself.

How do webhooks differ?

GoatLabels sends signed webhooks for tracking and label events, so the change is the endpoint URL and the signature verification step. Everything downstream — how you update an order, notify a buyer, or close a ticket — stays untouched, and you can drop any polling you added to work around gaps.

How does funding work after the switch?

Labels debit a prepaid wallet you top up with card, Apple Pay, Google Pay, ACH bank transfer, or crypto, rather than accruing on a monthly platform invoice. Accepted voids credit the wallet directly, and the dashboard and the API spend the same balance, so there is nothing to reconcile between them.

Can I keep both integrations running?

Yes. There is no monthly fee on Free (up to 50 shipments a month) and no per-call fee, so an overlap costs only the labels you actually buy on each side. Most teams run the rates call in both for a week before moving purchases.

What do I lose by moving?

Carrier breadth, if you ship outside USPS, UPS, FedEx, and DHL; that is the honest trade and it is the first thing to check. What you gain is a free unlimited API with no per-label platform fee, a dashboard and To Ship queue your support team can use, and Billy for the orders that never reached your API.

A migration guide for dev teams.

Migrating an integration off EasyPost, step by step

Four endpoints, one webhook, no more fees.

Porting from EasyPost means remapping a handful of REST endpoints — rates, buy, void, track — after which every API call on GoatLabels is free at any volume.

Get an API key Log in

The same four calls pointed somewhere cheaper

Rates, buy, void, track: USPS, UPS and FedEx on domestic parcels, DHL on international lanes, over REST and JSON with Bearer auth.

DHL: international

Live quotes One rates response.

Idempotent Retries stay safe.

OpenAPI 3.1 Generate your client.

Prepaid wallet after the cutover

Card, Apple Pay, Google Pay, ACH, or crypto — labels debit a balance, not a monthly invoice.

One balance API and dashboard.

Free overlap Run both, pay nothing extra.

Accepted voids credited Back to the wallet.

Endpoint mapping

What each EasyPost call becomes here.

Every shipping API models the same five nouns, which is why this is a remap rather than a rewrite. Here is where each part of your existing integration lands.

	On GoatLabels	What changes in your code
Create a shipment	POST /api/v1/shipments with from, to, and parcel — one JSON body, Bearer auth.	Your existing create call. The fields you already collect map across directly.
Get rates	Rates come back for USPS, UPS and FedEx as all-in prices on a domestic shipment, plus DHL on international lanes.	Wherever your code reads the rates array today, read ours instead.
Buy a label	Purchase the chosen rate; the label debits your prepaid wallet, not a monthly invoice.	Your buy step, minus the account funding assumptions behind it.
Void a label	Void by shipment id; after the carrier accepts the void, the amount is credited back to the wallet balance.	Refund flow. Same trigger point in your code; on EasyPost the Wallet credit waits for the carrier to approve.
Tracking updates	Signed webhooks for tracking and label events — verify the signature, drop the poller.	Swap the webhook URL and the signature verification; the event handling stays yours.
Retry safety	Idempotency keys on writes: a retried purchase returns the original label, never a second one.	Keep the retry logic you already trust; it just costs nothing to run here.

EasyPost is a trademark of its owner and is not affiliated with GoatLabels. This table describes the GoatLabels API and the concepts common to shipping APIs. EasyPost's fees and refund rules are dated and linked in the source block below; check EasyPost's current docs for its side.

Three reasons the port is smaller than it looks.

It is a remap, not a rewrite

Your integration already models a shipment, a rate, a purchase, a void, and a tracking event, because every shipping API models those. Porting means pointing four calls at new URLs and re-reading the response shapes — the business logic around them does not move.

The variable line disappears

After the cutover, API calls cost nothing at any volume. Retries, health checks, and re-quotes stop being budget decisions, and next month's shipping forecast is shipments times carrier rate with no per-label platform fee, plus Pro's flat fee once you pass Free's 50 shipments a month.

You can run both at once

Free has no monthly fee for up to 50 shipments a month, so the overlap period costs only labels. Send a slice of live traffic to the new integration, compare the all-in rates against what you would have bought, and move the rest when the numbers agree.

And when EasyPost is the right choice

You ship on a carrier or service outside USPS, UPS, FedEx, and DHL — that is our honest list, and no migration guide fixes a missing carrier.
Your integration depends on negotiated carrier contracts held on your own accounts, which EasyPost supports on its paid BYOCA plan and GoatLabels does not.
Your volume genuinely sits inside the free tier and your integration is stable — porting working code for a fee you are not paying is not engineering, it is churn.

What EasyPost's own pages say, checked 2026-10-17

The Free Access plan includes up to 3,000 labels a month on EasyPost Wallet carriers, with postage paid separately. (EasyPost Support: Billing and Payments)
Bring Your Own Carrier Accounts (BYOCA) costs $20 a month and includes no free monthly labels. (EasyPost Support: Billing and Payments)
The Enterprise plan is custom pricing based on volume, quoted by sales. (EasyPost pricing)
Each Wallet-carrier label past 3,000 in a month costs $0.08, and every BYOCA label costs $0.08. (EasyPost Support: Billing and Payments)
Rating more than three times as many shipments as you buy labels for costs $0.02 per extra rated shipment. (EasyPost Support: Billing and Payments)
EasyPost lists more than 100 carriers, and its Wallet carriers need no carrier contract of your own. (EasyPost carriers)
A label can be refunded only before the shipment starts moving, USPS refunds must be requested within 30 days, and a successful carrier refund also returns EasyPost's label fee. (EasyPost Support: Refunds)
Refunds on Wallet-carrier labels return to the EasyPost Wallet once the carrier approves them, which EasyPost says takes 2 to 4 weeks. (EasyPost Support: Request a refund for an unused shipping label)
Besides the API, EasyPost offers a no-code Create Label interface in its dashboard, with CSV upload of up to 500 labels at once. (EasyPost Create Label)
EasyPost's Luma AI products, sold through its sales team, answer questions about your shipping data and automatically choose a shipping option. (EasyPost Luma AI Advisor)

Checked on 2026-10-17 from EasyPost's own pages. Plans, fees and policies change, so confirm on the vendor's current page before you decide. EasyPost is a trademark of its owner and is not affiliated with GoatLabels.

The cutover, in order

Rates in parallel, then buy, then webhooks. Cut over when the diff is boring.

Start with the read-only call: point a copy of your rating step at GoatLabels and log both responses side by side for a week. Because rate lookups are unmetered, that parallel run costs nothing at all. Then move purchases behind a flag on a slice of live orders — idempotency keys mean a retry during the transition cannot produce two labels — and confirm the all-in price hitting the wallet matches the quote your code read. Voids and tracking webhooks follow the shipments the new path created, so they migrate last and by themselves. Finally, delete the polling you wrote to compensate for missed events and let the signed webhooks carry it.

Any order shape in

API, store sync, DM, or screenshot

maya_boutique

Hey! 2x hoodies (M) 1x tee (L) 😅 Ship to: Maya R. Austin, TX 78701

Shopify

Synced into To Ship

Etsy

Synced into To Ship

DM screenshot

Order: #1847
Customer: Jordan Lee
Items: 1x Hoodie (L)
Address: Brooklyn, NY

Drop the screenshot or paste the DM

Your API keeps its intake path; connectors and the dashboard cover the orders it never received.

Billy AI

The exceptions queue you were about to build.

Reads a pasted order, a screenshot, a voice note, or a synced record
Fills the addresses and the package details
Rate-shops USPS, UPS and FedEx at the all-in price, DHL on international lanes
Included free, so support stops filing integration tickets

Drafted. Checked. Yours to confirm.

Clean label out

Bought from the wallet

Paid from your prepaid balance

Card, Apple Pay, Google Pay, ACH, or crypto

$12.47

Label purchased

USPS Priority Mail — all-in rate

$12.47

Signed webhooks replace the poller. Accepted voids credit the wallet the purchase debited.

What you can stop maintaining.

Connectors for the storefronts, less code for you.

Shopify, Etsy, WooCommerce, eBay and Wix sync into To Ship and push tracking back when a label prints. If your integration currently carries that plumbing, the migration is a chance to delete it rather than port it.

Shopify

Etsy

WooCommerce

eBay

Wix

Connect a store Or use the API

What survives the port, and what you gain.

Everything your integration relies on.
Plus the parts you were writing yourself.

A migration should not cost you rate shopping, idempotency, or webhooks — those all come across. What arrives with them is a dashboard your support team can use, AI drafting for the orders that never reached your API, and a wallet instead of a platform invoice.

One prepaid wallet,
five ways to fund it

Card, Apple Pay, Google Pay, ACH bank transfer, and crypto all top up the same balance, and every method buys identical rates, carriers, and features. Voiding over the API credits that same balance after the carrier accepts the void.

Wallet balance

$1,247.36 USD

AI drafting for the orders
your API never saw

A DM, a comment thread, a voice note, a screenshot — Billy reads any of them into a drafted label. Every one of those is an edge case you would otherwise ticket, scope, and ship.

Billy LIVE

Where's the package to Maya?

It's in transit via UPS. Expected Friday, Aug 7.

1Z8923A6B05G4123456

In transit

Austin, TX → Dallas, TX

Ask Billy anything...

No monthly fee
to print

On Free (50 shipments a month) the overlap period costs only the labels you buy, which is what makes a parallel run practical. Past 50 a month, Pro is one flat $40 monthly plan with unlimited shipments.

Shipment summary

UPS Ground $12.49

Insurance $0.75

Fuel surcharge $0.32

Total $13.56

USPS, UPS, FedEx, and DHL
in one account

One rates call returns an all-in price per carrier (USPS, UPS and FedEx domestic, DHL on international lanes), and the number your code selects is the exact amount that leaves the balance. Rates are built into the account, so the migration does not stall on carrier contract negotiation.

Compare rates

UPS $12.48

FedEx $13.22

DHL $14.10

USPS $11.79

Duties inside the quote where DDP applies

Idempotency and webhooks
you already assume

REST and JSON, one Bearer header, idempotency keys on writes, signed webhooks for tracking and label events, and an OpenAPI 3.1 spec so you can regenerate a client instead of hand-writing one.

POST /v1/shipments

{

"to": { "name": "Maya" },

"from": { "name": "Alex" },

"service": "ups_ground",

"label_format": "pdf"

}

Webhook delivered

GoatLabels mobile shipments queue with all-in carrier prices

Billy drafting a label from a pasted DM on mobile

Label ready

CL-1038 · Brooklyn, NY

Ship while the port is in flight

A dashboard on the same account.

During a migration the worst moment is the label nobody can print because the code is half-moved. The web and mobile app runs on the same account and the same balance, so anyone can buy, reprint, or void a shipment manually while the integration catches up.

Paste the DM, snap the thread, or drop the screenshot — Billy pulls the name, the address, and the parcel out of it.

Reprint or void a label your code bought, without shipping an admin tool first.

USPS, UPS and FedEx come back as all-in prices on one screen, DHL on international lanes.

Buy from the prepaid balance and one-tap print to a share sheet or a thermal printer over Wi-Fi.

Hold the mic at the packing table and say the address — Billy drafts it and reads the rate back.

Debugging without a query console

Talk to Billy, not to your logs.

Mid-migration, half the questions are just where did this parcel go and what did it cost. Hold the mic, ask, and Billy answers from the same shipments your API created, then drafts the next label against the same prepaid balance. This is the real product, not a render.

Billy reading back a parcel's tracking history over the purchased labels list

Listening

"Where's Maya's package?"

Out for delivery

CL-1039 · Austin, TX · by 6 PM

Plain English in — names, addresses, weights, carriers, services · same shipments your API created · reads the all-in rate back before a cent leaves the wallet · phone, browser, or Telegram on Pro.

All-in quotes

The quote is the debit.

Three carriers on the same parcel, each an all-in number that is the exact amount leaving your prepaid balance. That is what makes a parallel run easy to evaluate: the price your code read is the price that moved, with no platform fee to add back before you compare.

CA → NY 2.6 lbs 12×8×4 in

USPS

Ground Advantage

2 to 5 days

$11.40

all-in · no surprises

Cheapest

UPS

Ground

1 to 5 days

$9.85

all-in · no surprises

FedEx

Ground

1 to 5 days

$11.20

all-in · no surprises

No carrier invoice the day after Accepted void → credit back to the wallet you funded Multi-currency display

Public API v1

Port it here. Then stop paying per shipment.

REST, JSON, one Bearer header. Real idempotency keys so a retried request cannot double-buy a label, signed webhooks for tracking and label events instead of polling, and errors that name what to fix. The OpenAPI 3.1 spec means your client can be generated rather than transcribed.

Create, rate-shop, and buy — the same three calls you already write

Signed webhooks for tracking and label events instead of polling

Real idempotency keys — a retried request never buys two labels

OpenAPI 3.1 spec, no SDK lock-in, unlimited calls on every plan

Read the API docs Get an API key $0 on every plan

curl https://api.goatlabels.io/api/v1/shipments

201 Created

request response

POST /api/v1/shipments
Authorization: Bearer sk_live_…
Idempotency-Key: ord_8421

{
  "to": { "name": "Joyce", "city": "Berlin", "country": "DE" },
  "parcel": { "weight": 2.6, "weight_unit": "lb" },
  "service": "fedex_intl_priority"
}

← 201 Created // buy it with POST /api/v1/shipments/{id}/purchase
{
  "id": "shp_44819",
  "status": "draft",
  "amount": { "subtotal": 72.25, "duty_and_tax": 14.20, "total": 86.45 }
}

What the migration is worth

After the cutover, calls are free.

Free covers 50 shipments a month with the public API, the store connectors, and Billy all unlimited underneath it — the quoted label price is what you pay from a prepaid wallet. Pro is a flat monthly fee for unlimited shipments and Billy on Telegram. Neither plan meters requests, which is what makes the parallel run and the eventual volume both free.

Pro

Free

$0 / forever

Enough to run the whole parallel evaluation on.

50 shipments a month, no monthly fee

USPS, UPS and FedEx on every domestic parcel; DHL on international lanes

The full REST API with unlimited calls and signed webhooks

Billy AI in the web app, unlimited — paste, screenshot, or speak

Store connectors included: Shopify, Etsy, WooCommerce, eBay and Wix

Start free

Billy is not a paid tier

The assistant that reads a DM, a screenshot, or a voice note into a drafted label runs unlimited in the web app on Free. Pro adds Billy on Telegram.

Web, every plan

Telegram, Pro

API free on every plan

GET /api/v1/shipments

200 OK · plan: free

Unlimited calls on Free — still unlimited on Pro.

Bring the invoice you pay today

High-volume shippers can ask about custom pricing, which we review account by account. Compare it against what you pay on

ShippoPirate ShipShipStation

No contracts No monthly fee Free to sign up

Label prices are quoted live from USPS, UPS and FedEx on domestic parcels and DHL on international lanes, shown as one all-in number, the same number that leaves your wallet. EasyPost's allowance and per-label fee are in the dated source block on this page; model the saving against them. Full pricing details

Who should schedule the port

Not every integration is worth moving.

A migration is only ever worth its own cost, so this is the shortlist of teams for whom the maths clears — and the ones who should leave working code alone are named on this page too.

Teams past the free-tier cap

TikTok Shop & live commerce

Unlimited

If the platform line on your bill now grows every month, a few days of remapping buys back a variable cost permanently.

4 carriers behind one API unlimited API calls free overlap period

GoatLabels shipments queue with purchased labels

Teams without carrier contracts

Etsy & independent creators

If you never negotiated your own accounts, a platform built around bringing them is doing you no favours. Rates come with the account here.

Rates first, then buy

Order #1024 · parallel run, zero call cost

Sellers living in the DMs

The orders that never became JSON

got the dress! can you ship to Austin?

Label drafted · CL-1024

Devs who inherited the integration

REST and the UI, one balance

calls to remap: rates, buy, void, track

Real sellers, real words

Teams running on the API they ported to.

A video took off and I had 80 TikTok Shop orders by morning. I printed every label from my phone on the bus to the post office.

Early customer · TikTok

TikTok Shop seller

TikTok Shop

I run my Etsy shop from the kitchen. The AI reads the order, picks the carrier, the label prints. That's the whole workflow now.

Early customer · Etsy

Etsy maker

Etsy

The API is what every shipping API pretends to be. Idempotency that actually works.

Sasha R.

Staff engineer, marketplace

API user

EasyPost migration FAQ

How hard is it to migrate from EasyPost to GoatLabels?: For most teams it is a few days of work, because the concepts line up one to one: create a shipment, read rates, buy the chosen rate, void when needed, and receive tracking webhooks. You remap those calls to the GoatLabels REST endpoints, swap the Bearer token, re-point and re-verify the webhook, and keep the surrounding business logic exactly as it is.
What is the recommended migration order?: Rates first, because it is read-only and free — run it in parallel and diff the prices against what you pay now. Then buy, behind a feature flag on a slice of traffic. Then void and webhooks, since they follow the shipments the new path created. Cut the remaining traffic over once a week of real orders looks right.
Do I need to change my retry logic?: No, and you should keep it. Writes accept an idempotency key, so a retried purchase returns the original label rather than buying a second one. Because calls are unlimited and free, aggressive retries cost nothing beyond the label itself.
How do webhooks differ?: GoatLabels sends signed webhooks for tracking and label events, so the change is the endpoint URL and the signature verification step. Everything downstream — how you update an order, notify a buyer, or close a ticket — stays untouched, and you can drop any polling you added to work around gaps.
How does funding work after the switch?: Labels debit a prepaid wallet you top up with card, Apple Pay, Google Pay, ACH bank transfer, or crypto, rather than accruing on a monthly platform invoice. Accepted voids credit the wallet directly, and the dashboard and the API spend the same balance, so there is nothing to reconcile between them.
Can I keep both integrations running?: Yes. There is no monthly fee on Free (up to 50 shipments a month) and no per-call fee, so an overlap costs only the labels you actually buy on each side. Most teams run the rates call in both for a week before moving purchases.
What do I lose by moving?: Carrier breadth, if you ship outside USPS, UPS, FedEx, and DHL; that is the honest trade and it is the first thing to check. What you gain is a free unlimited API with no per-label platform fee, a dashboard and To Ship queue your support team can use, and Billy for the orders that never reached your API.

Still deciding rather than porting? Read GoatLabels vs EasyPost, the pricing teardown, or what the free unlimited API covers. Planning the port? Start with the shipping API for developers overview and the API reference.

Run the rates call in parallel this week.

Remap four endpoints.
Delete the per-shipment fee.

Generate an API key, fund a wallet with card, Apple Pay, Google Pay, ACH, or crypto, and diff your next real quote against USPS, UPS and FedEx (DHL on international lanes) before you move a single purchase.

Get an API key Talk to us

Sign up in seconds, no card required. Your first top-up may need an approved application. No monthly fee on Free, up to 50 shipments a month.

Migrating an integration off EasyPost, step by step

The same four calls pointed somewhere cheaper

Prepaid wallet after the cutover

What each EasyPost call becomes here.

Three reasons the port is smaller than it looks.

It is a remap, not a rewrite

The variable line disappears

You can run both at once

And when EasyPost is the right choice

What EasyPost's own pages say, checked 2026-10-17

Rates in parallel, then buy, then webhooks. Cut over when the diff is boring.

The exceptions queue you were about to build.

Connectors for the storefronts, less code for you.

Everything your integration relies on. Plus the parts you were writing yourself.

One prepaid wallet, five ways to fund it

AI drafting for the orders your API never saw

No monthly fee to print

USPS, UPS, FedEx, and DHL in one account

Idempotency and webhooks you already assume

A dashboard on the same account.

Talk to Billy, not to your logs.

The quote is the debit.

USPS

UPS

FedEx

Port it here. Then stop paying per shipment.

After the cutover, calls are free.

Pro

Free

Billy is not a paid tier

API free on every plan

Bring the invoice you pay today

Not every integration is worth moving.

Teams past the free-tier cap

Teams without carrier contracts

Sellers living in the DMs

Devs who inherited the integration

Teams running on the API they ported to.

EasyPost migration FAQ

Remap four endpoints. Delete the per-shipment fee.

Everything your integration relies on.
Plus the parts you were writing yourself.

One prepaid wallet,
five ways to fund it

AI drafting for the orders
your API never saw

No monthly fee
to print

USPS, UPS, FedEx, and DHL
in one account

Idempotency and webhooks
you already assume

Remap four endpoints.
Delete the per-shipment fee.