> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to EasyPost

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.

**Authentication:** API Key
**Categories:** Automation, Productivity
**Tools:** 30: 16 read, 11 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=EASYPOST)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the EasyPost connection

   In **AgentKit > Connections**, create an EasyPost connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'easypost_address_get',
  toolInput: {
    address_id: '<address_id>',
  },
  connector: 'easypost',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="easypost_address_get",
    tool_input={
        "address_id": "<address_id>",
    },
    connection_name="easypost",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `easypost_address_get`

Get Address · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address_id` (`string`, required): ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae

Example input: `{"address_id":"<address_id>"}`

### `easypost_address_verify`

Verify Address · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address_id` (`string`, required): ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae

Example input: `{"address_id":"<address_id>"}`

### `easypost_addresses_list`

List Addresses · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: adr_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: adr_abc123
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `easypost_events_list`

List Events · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: evt_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: evt_abc123
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `easypost_parcel_get`

Get Parcel · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `parcel_id` (`string`, required): ID of the parcel, starting with prcl_. Example: prcl_e0aab4dd1d4d4f9d8a64b0d1a4b4a2d7

Example input: `{"parcel_id":"<parcel_id>"}`

### `easypost_pickup_get`

Get Pickup · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pickup_id` (`string`, required): ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e

Example input: `{"pickup_id":"<pickup_id>"}`

### `easypost_rates_retrieve`

Retrieve Rates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from_address` (`object`, required): 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"}
- `parcel` (`object`, required): 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_address` (`object`, required): 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_accounts` (`array`, optional): Carrier account IDs (ca_...) to rate with; defaults to all of the account's carriers. Example: ["ca_8dc116debcdb49b5a66a2ddee4612600"]

Example input: `{"from_address":{"company":"EasyPost","street1":"417 Montgomery Street","street2":"5th Floor","city":"San Francisco","state":"CA","zip":"94104","country":"US","phone":"4153334445"},"parcel":{"length":20.2,"width":10.9,"height":5,"weight":65.9},"to_address":{"name":"Dr. Steve Brule","street1":"179 N Harbor Dr","city":"Redondo Beach","state":"CA","zip":"90277","country":"US","phone":"8573875756"}}`

### `easypost_refund_get`

Get Refund · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `refund_id` (`string`, required): ID of the refund, starting with rfnd_. Example: rfnd_d3e4f5a6b7c84d9e0f1a2b3c4d5e6f7a

Example input: `{"refund_id":"<refund_id>"}`

### `easypost_refunds_list`

List Refunds · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: rfnd_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: rfnd_abc123
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `easypost_scan_forms_list`

List ScanForms · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: sf_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: sf_abc123
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `easypost_shipment_get`

Get Shipment · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `shipment_id` (`string`, required): ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"shipment_id":"<shipment_id>"}`

### `easypost_shipment_label_convert`

Convert Shipment Label · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_format` (`string`, required): Label format to generate: PDF, ZPL or EPL2. Example: PDF. One of: `PDF`, `ZPL`, `EPL2`.
- `shipment_id` (`string`, required): ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"file_format":"PDF","shipment_id":"<shipment_id>"}`

### `easypost_shipment_smartrates_get`

Get Shipment SmartRates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `shipment_id` (`string`, required): ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"shipment_id":"<shipment_id>"}`

### `easypost_shipments_list`

List Shipments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: shp_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: shp_abc123
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `include_children` (`boolean`, optional): true to include shipments of child users. Example: false
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `purchased` (`boolean`, optional): true for only shipments with a purchased label, false for only unpurchased. Leave empty for all. Example: true
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `easypost_tracker_get`

Get Tracker · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tracker_id` (`string`, required): ID of the tracker, starting with trk_. Example: trk_5c5f1f2a3b4c4d5e6f7a8b9c0d1e2f3a

Example input: `{"tracker_id":"<tracker_id>"}`

### `easypost_trackers_list`

List Trackers · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after_id` (`string`, optional): Return records created after this ID. Example: trk_abc123
- `before_id` (`string`, optional): Return records created before this ID; pass the last ID of the previous page to get the next page. Example: trk_abc123
- `carrier` (`string`, optional): Only trackers for this carrier. Example: USPS
- `end_datetime` (`string`, optional): Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
- `page_size` (`integer`, optional): Records per page, up to 100 (default 20). Example: 20
- `start_datetime` (`string`, optional): Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
- `tracking_code` (`string`, optional): Only trackers for this tracking code. Example: EZ1000000001

Example input: `{}`

### `easypost_address_create`

Create Address · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `street1` (`string`, required): First line of the street address. Example: 417 Montgomery Street
- `city` (`string`, optional): City. Example: San Francisco
- `company` (`string`, optional): Organization name. Example: EasyPost
- `country` (`string`, optional): ISO 3166 two-letter country code. Defaults to US. Example: US
- `email` (`string`, optional): Email address. Example: jane@example.com
- `name` (`string`, optional): Person's name. Example: Jane Doe
- `phone` (`string`, optional): Phone number. Example: 415-123-4567
- `residential` (`boolean`, optional): Whether the address is residential, which affects some carrier rates. Example: false
- `state` (`string`, optional): State or province. Example: CA
- `street2` (`string`, optional): Second address line, such as a suite or unit. Example: Floor 5
- `verify` (`boolean`, optional): 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_carrier` (`string`, optional): Carrier-grade verification with ups or fedex; use together with verify or verify_strict. Example: ups. One of: `ups`, `fedex`.
- `verify_strict` (`boolean`, optional): true to verify and return an error if any check fails. Like verify, it runs whenever it is sent. Example: true
- `zip` (`string`, optional): ZIP or postal code. Example: 94104

Example input: `{"street1":"<street1>"}`

### `easypost_address_create_and_verify`

Create and Verify Address · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `street1` (`string`, required): First line of the street address. Example: 417 Montgomery Street
- `city` (`string`, optional): City. Example: San Francisco
- `company` (`string`, optional): Organization name. Example: EasyPost
- `country` (`string`, optional): ISO 3166 two-letter country code. Defaults to US. Example: US
- `email` (`string`, optional): Email address. Example: jane@example.com
- `name` (`string`, optional): Person's name. Example: Jane Doe
- `phone` (`string`, optional): Phone number. Example: 415-123-4567
- `residential` (`boolean`, optional): Whether the address is residential, which affects some carrier rates. Example: false
- `state` (`string`, optional): State or province. Example: CA
- `street2` (`string`, optional): Second address line, such as a suite or unit. Example: Floor 5
- `verify_carrier` (`string`, optional): Carrier-grade verification with ups or fedex. Example: fedex. One of: `ups`, `fedex`.
- `zip` (`string`, optional): ZIP or postal code. Example: 94104

Example input: `{"street1":"<street1>"}`

### `easypost_parcel_create`

Create Parcel · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `weight` (`number`, required): Weight in ounces. Example: 65.9
- `height` (`number`, optional): Height in inches. Example: 5
- `length` (`number`, optional): Length in inches. Required with width and height unless predefined_package is set. Example: 20.2
- `predefined_package` (`string`, optional): Carrier package name instead of dimensions, such as FlatRateEnvelope or SmallFlatRateBox. Example: FlatRateEnvelope
- `width` (`number`, optional): Width in inches. Example: 10.9

Example input: `{"weight":65.9}`

### `easypost_pickup_buy`

Buy Pickup · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `carrier` (`string`, required): Carrier from the pickup's pickup_rates. Example: UPS
- `pickup_id` (`string`, required): ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e
- `service` (`string`, required): Service from the pickup's pickup_rates. Example: Same-day Pickup

Example input: `{"carrier":"<carrier>","pickup_id":"<pickup_id>","service":"<service>"}`

### `easypost_pickup_create`

Create Pickup · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): 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_datetime` (`string`, required): Latest pickup time. Example: 2026-11-17 17:00:00
- `min_datetime` (`string`, required): Earliest pickup time. Example: 2026-11-17 10:30:00
- `batch` (`object`, optional): A purchased batch to pick up, as {"id": "batch_..."}. Example: {"id": "batch_7f8e9d0c1b2a"}
- `carrier_accounts` (`array`, optional): Carrier accounts to request rates from, as [{"id": "ca_..."}]. Example: [{"id": "ca_8dc116debcdb49b5a66a2ddee4612600"}]
- `instructions` (`string`, optional): Instructions for the driver. Example: Packages are at the front desk
- `is_account_address` (`boolean`, optional): true if the pickup address is the carrier account's address. Example: false
- `reference` (`string`, optional): Your reference for the pickup. Example: pickup-1001
- `shipment` (`object`, optional): The purchased shipment to pick up, as {"id": "shp_..."}. Provide shipment or batch. Example: {"id": "shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b"}

Example input: `{"address":{"id":"adr_7c2f357c2d1511f087fbac1f6bc539ae"},"max_datetime":"<max_datetime>","min_datetime":"<min_datetime>"}`

### `easypost_scan_form_create`

Create ScanForm · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `shipments` (`array`, required): Purchased shipments to include, as [{"id": "shp_..."}]. Example: [{"id": "shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b"}]

Example input: `{"shipments":[{"id":"shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b"}]}`

### `easypost_shipment_buy`

Buy Shipment Label · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `rate_id` (`string`, required): ID of the rate to buy, from the shipment's rates[] (rate_...). Example: rate_4c1e2c1b2f4a4f6d9a7e1b6f5d3c2a1b
- `shipment_id` (`string`, required): ID of the shipment to buy, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b
- `end_shipper_id` (`string`, optional): EndShipper ID (es_...) to record as the shipper, where the carrier requires one. Example: es_1b2c3d4e5f
- `insurance` (`string`, optional): Amount in USD to insure the shipment for, as a string; EasyPost charges an insurance fee. Example: 249.99

Example input: `{"rate_id":"<rate_id>","shipment_id":"<shipment_id>"}`

### `easypost_shipment_create`

Create Shipment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from_address` (`object`, required): 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"}
- `parcel` (`object`, required): 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_address` (`object`, required): 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_accounts` (`array`, optional): Carrier account IDs (ca_...) to rate with; defaults to all of the account's carriers. Example: ["ca_8dc116debcdb49b5a66a2ddee4612600"]
- `customs_info` (`object`, optional): 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_return` (`boolean`, optional): true to create a return shipment (addresses are swapped on the label). Example: false
- `line_items` (`array`, optional): 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"}]
- `options` (`object`, optional): 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"}
- `reference` (`string`, optional): Your reference for the shipment, such as an order number. Example: ORDER-1001
- `return_address` (`object`, optional): 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_..."}
- `service` (`string`, optional): 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

Example input: `{"from_address":{"company":"EasyPost","street1":"417 Montgomery Street","street2":"5th Floor","city":"San Francisco","state":"CA","zip":"94104","country":"US","phone":"4153334445"},"parcel":{"length":20.2,"width":10.9,"height":5,"weight":65.9},"to_address":{"name":"Dr. Steve Brule","street1":"179 N Harbor Dr","city":"Redondo Beach","state":"CA","zip":"90277","country":"US","phone":"8573875756"}}`

### `easypost_shipment_insure`

Insure Shipment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`string`, required): Value to insure in USD, as a string. Example: 200
- `shipment_id` (`string`, required): ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"amount":"<amount>","shipment_id":"<shipment_id>"}`

### `easypost_shipment_rates_regenerate`

Regenerate Shipment Rates · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `shipment_id` (`string`, required): ID of the shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"shipment_id":"<shipment_id>"}`

### `easypost_tracker_create`

Create Tracker · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `tracking_code` (`string`, required): Carrier tracking number. In test mode, codes such as EZ1000000001 return simulated events. Example: EZ1000000001
- `carrier` (`string`, optional): Carrier name, such as USPS, UPS or FedEx. Detected automatically when empty. Example: USPS

Example input: `{"tracking_code":"<tracking_code>"}`

### `easypost_pickup_cancel`

Cancel Pickup · Destructive

Cancel a scheduled pickup.
Returns the Pickup with status canceled.
Use easypost_pickup_cancel to call off a pickup bought with easypost_pickup_buy.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `pickup_id` (`string`, required): ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e

Example input: `{"pickup_id":"<pickup_id>"}`

### `easypost_refund_create`

Create Refund · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `carrier` (`string`, required): Carrier of the labels. Example: USPS
- `tracking_codes` (`array`, required): Tracking codes of the labels to refund. Example: ["EZ1000000001"]

Example input: `{"carrier":"<carrier>","tracking_codes":["EZ1000000001"]}`

### `easypost_shipment_refund`

Refund Shipment Label · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `shipment_id` (`string`, required): ID of the purchased shipment, starting with shp_. Example: shp_2a5a4b0e1c7d4e8f9a0b1c2d3e4f5a6b

Example input: `{"shipment_id":"<shipment_id>"}`

## Related

Other Automation connectors ([all 91](/agentkit/connectors/?category=automation)):

- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twilio](/agentkit/connectors/twilio/): Scalekit connector, Username and password, 61 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
