The EasyPost connector lets your AI agent act in each user's EasyPost account. Each user connects their own EasyPost API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 16 · 11 · 316 read11 write3 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the EasyPost connection
In AgentKit > Connections, create an EasyPost connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_tooleasypost_address_getGet one address by ID.Read-onlyGet Address
Get one address by ID. Returns the Address with its fields, residential flag and any verification results. Use easypost_address_get for a known ID. Use easypost_addresses_list to browse.
Inputs
address_idstringrequired- ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae
easypost_address_verifyRun delivery and ZIP+4 verification on an address that already exists.Read-onlyVerify Address
Run delivery and ZIP+4 verification on an address that already exists. Returns the Address with verifications results and any corrections. Use easypost_address_verify for a saved address ID. Use easypost_address_create_and_verify for a new address.
Inputs
address_idstringrequired- ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae
easypost_addresses_listList the account's addresses, newest first, with cursor paging.Read-onlyList Addresses
List the account's addresses, newest first, with cursor paging. Returns addresses[] and has_more. Use easypost_addresses_list to browse addresses. Use easypost_address_get for one.
Inputs
after_idstring- Return records created after this ID. Example: adr_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: adr_abc123
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
easypost_events_listList webhook events (tracker updates, batch and refund changes, payments), newest first.Read-onlyList Events
List webhook events (tracker updates, batch and refund changes, payments), newest first. Returns events[] with id, description (such as tracker.updated), status, result and created_at, and has_more. Use easypost_events_list to audit what EasyPost sent to webhooks.
Inputs
after_idstring- Return records created after this ID. Example: evt_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: evt_abc123
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
easypost_parcel_getGet one parcel by ID.Read-onlyGet Parcel
Get one parcel by ID. Returns the Parcel with length, width, height, weight and predefined_package. Use easypost_parcel_get for a known parcel ID.
Inputs
parcel_idstringrequired- ID of the parcel, starting with prcl_. Example: prcl_e0aab4dd1d4d4f9d8a64b0d1a4b4a2d7
easypost_pickup_getGet one pickup by ID.Read-onlyGet Pickup
Get one pickup by ID. Returns the Pickup with status, confirmation, min and max datetime, address and pickup_rates. Use easypost_pickup_get to check a pickup's status.
Inputs
pickup_idstringrequired- ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e
easypost_rates_retrieveGet carrier rates for a package without creating a shipment (stateless rating, beta endpoint).Read-onlyRetrieve Rates
Get carrier rates for a package without creating a shipment (stateless rating, beta endpoint). Returns rates[] with carrier, service, rate, currency and delivery_days; the rates cannot be bought. Use easypost_rates_retrieve for quotes. Use easypost_shipment_create when you will buy a label.
Inputs
from_addressobjectrequired- Origin address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"company": "EasyPost", "street1": "417 Montgomery Street", "street2": "5th Floor", "city": "San Francisco", "state": "CA", "zip": "94104", "country": "US", "phone": "4153334445"}
parcelobjectrequired- Package: length, width and height in inches and weight in ounces, or predefined_package, or {"id": "prcl_..."}. Example: {"length": 20.2, "width": 10.9, "height": 5, "weight": 65.9}
to_addressobjectrequired- Destination address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"name": "Dr. Steve Brule", "street1": "179 N Harbor Dr", "city": "Redondo Beach", "state": "CA", "zip": "90277", "country": "US", "phone": "8573875756"}
carrier_accountsarray- Carrier account IDs (ca_...) to rate with; defaults to all of the account's carriers. Example: ["ca_8dc116debcdb49b5a66a2ddee4612600"]
easypost_refund_getGet one label refund request by ID.Read-onlyGet Refund
Get one label refund request by ID. Returns the Refund with tracking_code, confirmation_number, status, carrier and shipment_id. Use easypost_refund_get for a known refund ID.
Inputs
refund_idstringrequired- ID of the refund, starting with rfnd_. Example: rfnd_d3e4f5a6b7c84d9e0f1a2b3c4d5e6f7a
easypost_refunds_listList label refund requests, newest first.Read-onlyList Refunds
List label refund requests, newest first. Returns refunds[] with tracking_code, carrier, status and shipment_id, and has_more. Use easypost_refunds_list to check refund progress. Use easypost_refund_get for one refund.
Inputs
after_idstring- Return records created after this ID. Example: rfnd_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: rfnd_abc123
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
easypost_scan_forms_listList ScanForms, newest first.Read-onlyList ScanForms
List ScanForms, newest first. Returns scan_forms[] with id, status, tracking_codes and form_url, and has_more. Use easypost_scan_forms_list to find earlier manifests.
Inputs
after_idstring- Return records created after this ID. Example: sf_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: sf_abc123
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
easypost_shipment_getGet one shipment by ID.Read-onlyGet Shipment
Get one shipment by ID. Returns the Shipment with addresses, parcel, rates, selected_rate, postage_label (label URLs), tracking_code, tracker, status, fees and refund_status. Use easypost_shipment_get to read a label URL or status. Use easypost_shipments_list to browse.
Inputs
shipment_idstringrequired- ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
easypost_shipment_label_convertGenerate the purchased label of a shipment in another file format.Read-onlyConvert Shipment Label
Generate the purchased label of a shipment in another file format. Returns the Shipment with postage_label holding the new label_pdf_url, label_zpl_url or label_epl2_url. Use easypost_shipment_label_convert when the printer needs PDF, ZPL or EPL2 instead of the default PNG.
Inputs
file_formatstringrequired- Label format to generate: PDF, ZPL or EPL2. Example: PDFone of
PDFZPLEPL2 shipment_idstringrequired- ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
easypost_shipment_smartrates_getGet SmartRate transit-time predictions for each rate of a domestic shipment.Read-onlyGet Shipment SmartRates
Get SmartRate transit-time predictions for each rate of a domestic shipment. Returns result[] with each rate plus time_in_transit percentiles (percentile_50 to percentile_99 days). Use easypost_shipment_smartrates_get to choose a rate by delivery confidence before easypost_shipment_buy.
Inputs
shipment_idstringrequired- ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
easypost_shipments_listList shipments, newest first, with cursor paging and a purchased filter.Read-onlyList Shipments
List shipments, newest first, with cursor paging and a purchased filter. Returns shipments[] and has_more. Use easypost_shipments_list to browse shipments. Use easypost_shipment_get for one.
Inputs
after_idstring- Return records created after this ID. Example: shp_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: shp_abc123
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
include_childrenboolean- true to include shipments of child users. Example: false
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
purchasedboolean- true for only shipments with a purchased label, false for only unpurchased. Leave empty for all. Example: true
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
easypost_tracker_getGet one tracker by ID.Read-onlyGet Tracker
Get one tracker by ID. Returns status, status_detail, est_delivery_date, carrier, public_url and tracking_details[] events. Use easypost_tracker_get for the latest status. Use easypost_trackers_list to find trackers by tracking code.
Inputs
tracker_idstringrequired- ID of the tracker, starting with trk_. Example: trk_5c5f1f2a3b4c4d5e6f7a8b9c0d1e2f3a
easypost_trackers_listList trackers, newest first, optionally for one tracking code or carrier.Read-onlyList Trackers
List trackers, newest first, optionally for one tracking code or carrier. Returns trackers[] and has_more. Use easypost_trackers_list to find a tracker by tracking code. Use easypost_tracker_get for one tracker.
Inputs
after_idstring- Return records created after this ID. Example: trk_abc123
before_idstring- Return records created before this ID; pass the last ID of the previous page to get the next page. Example: trk_abc123
carrierstring- Only trackers for this carrier. Example: USPS
end_datetimestring- Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
page_sizeinteger- Records per page, up to 100 (default 20). Example: 20
start_datetimestring- Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
tracking_codestring- Only trackers for this tracking code. Example: EZ1000000001
easypost_address_createCreate an address, optionally verifying it for deliverability and ZIP+4.WriteCreate Address
Create an address, optionally verifying it for deliverability and ZIP+4. Returns the Address with id (adr_...), the normalized fields and, when verification was requested, verifications.delivery and verifications.zip4 results. Use easypost_address_create to save an address for shipments. Use easypost_address_create_and_verify to fail when the address cannot be verified.
Inputs
street1stringrequired- First line of the street address. Example: 417 Montgomery Street
citystring- City. Example: San Francisco
companystring- Organization name. Example: EasyPost
countrystring- ISO 3166 two-letter country code. Defaults to US. Example: US
emailstring- Email address. Example: jane@example.com
namestring- Person's name. Example: Jane Doe
phonestring- Phone number. Example: 415-123-4567
residentialboolean- Whether the address is residential, which affects some carrier rates. Example: false
statestring- State or province. Example: CA
street2string- Second address line, such as a suite or unit. Example: Floor 5
verifyboolean- true to run delivery and ZIP+4 verification. Verification runs whenever this is sent, even as false, so leave it empty to skip. Example: true
verify_carrierstring- Carrier-grade verification with ups or fedex; use together with verify or verify_strict. Example: upsone of
upsfedex verify_strictboolean- true to verify and return an error if any check fails. Like verify, it runs whenever it is sent. Example: true
zipstring- ZIP or postal code. Example: 94104
easypost_address_create_and_verifyCreate an address and verify it in one call, returning an error if it cannot be verified.WriteCreate and Verify Address
Create an address and verify it in one call, returning an error if it cannot be verified. Returns the verified Address with id, corrected fields and verifications; fails with ADDRESS.VERIFY.FAILURE and field errors otherwise. Use easypost_address_create_and_verify to reject bad addresses. Use easypost_address_create with verify to save the address even when verification fails.
Inputs
street1stringrequired- First line of the street address. Example: 417 Montgomery Street
citystring- City. Example: San Francisco
companystring- Organization name. Example: EasyPost
countrystring- ISO 3166 two-letter country code. Defaults to US. Example: US
emailstring- Email address. Example: jane@example.com
namestring- Person's name. Example: Jane Doe
phonestring- Phone number. Example: 415-123-4567
residentialboolean- Whether the address is residential, which affects some carrier rates. Example: false
statestring- State or province. Example: CA
street2string- Second address line, such as a suite or unit. Example: Floor 5
verify_carrierstring- Carrier-grade verification with ups or fedex. Example: fedexone of
upsfedex zipstring- ZIP or postal code. Example: 94104
easypost_parcel_createCreate a parcel with dimensions in inches and weight in ounces, or a carrier predefined package.WriteCreate Parcel
Create a parcel with dimensions in inches and weight in ounces, or a carrier predefined package. Returns the Parcel with id (prcl_...). Use easypost_parcel_create to reuse a package in several shipments. easypost_shipment_create can also take the parcel inline.
Inputs
weightnumberrequired- Weight in ounces. Example: 65.9
heightnumber- Height in inches. Example: 5
lengthnumber- Length in inches. Required with width and height unless predefined_package is set. Example: 20.2
predefined_packagestring- Carrier package name instead of dimensions, such as FlatRateEnvelope or SmallFlatRateBox. Example: FlatRateEnvelope
widthnumber- Width in inches. Example: 10.9
easypost_pickup_buySchedule a pickup by buying one of its rates; carriers may charge for it.WriteBuy Pickup
Schedule a pickup by buying one of its rates; carriers may charge for it. Returns the Pickup with status scheduled and a confirmation number. Use easypost_pickup_buy after easypost_pickup_create. Use easypost_pickup_cancel to cancel it.
Inputs
carrierstringrequired- Carrier from the pickup's pickup_rates. Example: UPS
pickup_idstringrequired- ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e
servicestringrequired- Service from the pickup's pickup_rates. Example: Same-day Pickup
easypost_pickup_createCreate a carrier pickup request for a purchased shipment or batch, which returns pickup rates.WriteCreate Pickup
Create a carrier pickup request for a purchased shipment or batch, which returns pickup rates. Returns the Pickup with id (pickup_...), status unknown and pickup_rates[] (carrier, service, rate). Use easypost_pickup_create, then easypost_pickup_buy with a carrier and service from pickup_rates to schedule it.
Inputs
addressobjectrequired- Pickup address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"id": "adr_7c2f357c2d1511f087fbac1f6bc539ae"}
max_datetimestringrequired- Latest pickup time. Example: 2026-11-17 17:00:00
min_datetimestringrequired- Earliest pickup time. Example: 2026-11-17 10:30:00
batchobject- A purchased batch to pick up, as {"id": "batch_..."}. Example: {"id": "batch_7f8e9d0c1b2a"}
carrier_accountsarray- Carrier accounts to request rates from, as [{"id": "ca_..."}]. Example: [{"id": "ca_8dc116debcdb49b5a66a2ddee4612600"}]
instructionsstring- Instructions for the driver. Example: Packages are at the front desk
is_account_addressboolean- true if the pickup address is the carrier account's address. Example: false
referencestring- Your reference for the pickup. Example: pickup-1001
shipmentobject- The purchased shipment to pick up, as {"id": "shp_..."}. Provide shipment or batch. Example: {"id": "shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b"}
easypost_scan_form_createCreate a ScanForm (manifest) that lets the carrier scan many purchased shipments at once; shipments must share a from address and carrier.WriteCreate ScanForm
Create a ScanForm (manifest) that lets the carrier scan many purchased shipments at once; shipments must share a from address and carrier. Returns the ScanForm with id (sf_...), status, tracking_codes and form_url (PDF). Use easypost_scan_form_create at the end of the day before handoff.
Inputs
shipmentsarrayrequired- Purchased shipments to include, as [{"id": "shp_..."}]. Example: [{"id": "shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b"}]
easypost_shipment_buyBuy postage for a shipment using one of its rates; this charges the account (production key) and creates a tracker.WriteBuy Shipment Label
Buy postage for a shipment using one of its rates; this charges the account (production key) and creates a tracker. Returns the Shipment with postage_label (label_url), tracking_code, selected_rate, tracker and fees. Use easypost_shipment_buy after easypost_shipment_create, with a rate ID from its rates. Use easypost_shipment_refund to void an unused label.
Inputs
rate_idstringrequired- ID of the rate to buy, from the shipment's rates[] (rate_...). Example: rate_4c1e2c1b2f4a4f6d9a7e1b6f5d3c2a1b
shipment_idstringrequired- ID of the shipment to buy, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
end_shipper_idstring- EndShipper ID (es_...) to record as the shipper, where the carrier requires one. Example: es_1b2c3d4e5f
insurancestring- Amount in USD to insure the shipment for, as a string; EasyPost charges an insurance fee. Example: 249.99
easypost_shipment_createCreate a shipment from a to and from address and a parcel, which returns carrier rates.WriteCreate Shipment
Create a shipment from a to and from address and a parcel, which returns carrier rates. With service and one carrier account it also buys the label in the same call (one-call buy). Returns the Shipment with id (shp_...), rates[] (id, carrier, service, rate, delivery_days) and messages for carriers that failed to rate. Use easypost_shipment_create to compare rates, then easypost_shipment_buy with a rate ID. Use easypost_rates_retrieve for rates without saving a shipment.
Inputs
from_addressobjectrequired- Origin address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"company": "EasyPost", "street1": "417 Montgomery Street", "street2": "5th Floor", "city": "San Francisco", "state": "CA", "zip": "94104", "country": "US", "phone": "4153334445"}
parcelobjectrequired- Package: length, width and height in inches and weight in ounces, or predefined_package, or {"id": "prcl_..."}. Example: {"length": 20.2, "width": 10.9, "height": 5, "weight": 65.9}
to_addressobjectrequired- Destination address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"name": "Dr. Steve Brule", "street1": "179 N Harbor Dr", "city": "Redondo Beach", "state": "CA", "zip": "90277", "country": "US", "phone": "8573875756"}
carrier_accountsarray- Carrier account IDs (ca_...) to rate with; defaults to all of the account's carriers. Example: ["ca_8dc116debcdb49b5a66a2ddee4612600"]
customs_infoobject- Customs information for international shipments: contents_type, customs_certify, customs_signer, eel_pfc, and customs_items (each with description, quantity, value, weight, hs_tariff_number, origin_country), or {"id": "cstinfo_..."}. Example: {"contents_type": "merchandise", "customs_certify": true, "customs_signer": "Steve Brule", "eel_pfc": "NOEEI 30.37(a)", "customs_items": [{"description": "T-shirt", "quantity": 1, "value": 10, "weight": 5, "hs_tariff_number": "610910", "origin_country": "US"}]}
is_returnboolean- true to create a return shipment (addresses are swapped on the label). Example: false
line_itemsarray- Product values used only for USPS claims; each item has total_line_value (USD string) and item_description. Example: [{"total_line_value": "129.00", "item_description": "Mugs"}]
optionsobject- Shipment options, such as label_format (PNG, PDF, ZPL, EPL2), label_date, delivery_confirmation, saturday_delivery, print_custom_1, invoice_number. Example: {"label_format": "PDF", "invoice_number": "123"}
referencestring- Your reference for the shipment, such as an order number. Example: ORDER-1001
return_addressobject- Return address if different from from_address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"id": "adr_..."}
servicestring- Service to buy immediately with one-call buy (needs exactly one carrier account), such as Priority or NextDayAir. Leave empty to only get rates. Example: Priority
easypost_shipment_insureAdd EasyPost insurance to a purchased shipment that was bought without it; this charges an insurance fee.WriteInsure Shipment
Add EasyPost insurance to a purchased shipment that was bought without it; this charges an insurance fee. Returns the Shipment with insurance set. Use easypost_shipment_insure after buying. To insure at purchase time, pass insurance to easypost_shipment_buy instead.
Inputs
amountstringrequired- Value to insure in USD, as a string. Example: 200
shipment_idstringrequired- ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
easypost_shipment_rates_regenerateFetch fresh rates for an existing, unpurchased shipment.WriteRegenerate Shipment Rates
Fetch fresh rates for an existing, unpurchased shipment. Returns rates[] with new rate IDs. Use easypost_shipment_rates_regenerate when rates are stale before easypost_shipment_buy.
Inputs
shipment_idstringrequired- ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
easypost_tracker_createStart tracking a package by tracking code, for labels bought outside EasyPost (labels bought through EasyPost get a tracker automatically).WriteCreate Tracker
Start tracking a package by tracking code, for labels bought outside EasyPost (labels bought through EasyPost get a tracker automatically). EasyPost may charge a per-tracker fee. Returns the Tracker with id (trk_...), status, est_delivery_date and tracking_details events. Use easypost_tracker_create for an outside tracking number. Use easypost_tracker_get to refresh one you already created.
Inputs
tracking_codestringrequired- Carrier tracking number. In test mode, codes such as EZ1000000001 return simulated events. Example: EZ1000000001
carrierstring- Carrier name, such as USPS, UPS or FedEx. Detected automatically when empty. Example: USPS
easypost_pickup_cancelCancel a scheduled pickup.DestructiveCancel Pickup
Cancel a scheduled pickup. Returns the Pickup with status canceled. Use easypost_pickup_cancel to call off a pickup bought with easypost_pickup_buy.
Inputs
pickup_idstringrequired- ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e
easypost_refund_createRequest refunds for one or more purchased labels of one carrier by tracking code.DestructiveCreate Refund
Request refunds for one or more purchased labels of one carrier by tracking code. Returns an array of Refund objects with tracking_code, status (submitted, refunded or rejected) and shipment_id. Use easypost_refund_create for several labels at once. Use easypost_shipment_refund for one shipment ID.
Inputs
carrierstringrequired- Carrier of the labels. Example: USPS
tracking_codesarrayrequired- Tracking codes of the labels to refund. Example: ["EZ1000000001"]
easypost_shipment_refundRequest a refund (void) of a purchased, unused label.DestructiveRefund Shipment Label
Request a refund (void) of a purchased, unused label. Returns the Shipment with refund_status submitted, refunded or rejected. Use easypost_shipment_refund for one shipment. Use easypost_refund_create to refund several labels by tracking code.
Inputs
shipment_idstringrequired- ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
No tools match.