# eHub Guide

eHub is a shipping aggregation platform that provides access to multiple carriers through eHub Orchestrate.

Through the EasyPost API, eHub supports U.S. domestic shipments and enables merchants to retrieve rates, generate labels, void shipments, and receive tracking updates.

For operational details, shipment nuances, and frequently asked questions, refer to the eHub Carrier Support and FAQs article.

Related:

- [eHub Carrier Support & FAQs](https://support.easypost.com/hc/en-us/articles/44643699795597-eHub-Carrier-Support-and-FAQs)

---

## Carrier Account Setup

### Account Registration

Sign up for an EasyPost account to obtain a **Test** and **Production** API
key. See Authentication and Key Management for more information.

> Note: Negotiated rates are only available in Production mode.

### eHub Account Registration

1. Contact eHub to create a shipper account.
2. Inform eHub about using EasyPost’s API for label purchases.
3. Acquire rates and align any additional shipping needs.
4. Obtain the following test and production account credentials:
   1. `api_key`
5. Input carrier-specific credentials within the
   EasyPost Carrier Account Dashboard for comprehensive rate access.

### eHub Shipping Account via API

The API structure specified by EasyPost can also be used to add the eHub carrier shipper account.

```shell
curl -X POST https://api.easypost.com/v2/carrier_accounts \
  -u "$EASYPOST_API_KEY": \
  -H 'Content-Type: application/json' \
  -d '{
  "carrier_account": {
    "type": "EhubAccount",
    "description": "EhubAccount",
    "credentials": {
      "api_key": "VALUE"
    },
    "test_credentials": {
      "api_key": "VALUE"
    }
  }
}'
```

### Software Requirements

Download an EasyPost Client Library or utilize the REST API with cURL.

### Documentation Review

Examine the EasyPost Objects section to understand the API's structure, which is critical for constructing requests and interpreting responses.

Related:

- [Getting Started Guide](https://docs.easypost.com/guides/getting-started)
- [Manage Carrier Accounts](https://app.easypost.com/account/settings?tab=carriers)

---

## Rates

eHub is a **Live Rating** integration, enabling real-time rate retrieval for shipments created via EasyPost.

- When creating a shipment, EasyPost requests eHub for shipment rates specific to the user’s eHub account.
- The rates provided are directly from eHub and tailored to the user's specific account details.
- In cases of discrepancies or incorrect rates, users are advised to contact their eHub account representative.

---

## Billing

All eHub shipments purchased through EasyPost are billed by eHub in USD. Contact eHub for specific invoicing procedures.

Refer to the Help Center for more information about payment methods, wallet funding, or account billing.

---

## Service Levels

eHub offers the following service levels:

Service levels are generated from live carrier metadata and are not included in this file. Retrieve them from the Carrier Metadata endpoint: https://docs.easypost.com/docs/carrier-metadata. Use `carrier=ehub`.

---

## Hazardous Materials (HAZMAT)

The eHub policy on hazardous materials is not explicitly detailed in this guide. Shippers are advised to contact eHub directly for hazmat inquiries.

---

## Pickups

Pickup scheduling is not managed through the EasyPost API for eHub.

Pickups are coordinated directly through eHub. Requirements such as a Bill of Lading (BOL), pickup schedule, and on-site contact
coordination are handled directly through eHub.

---

## Tracking

EasyPost simplifies package tracking by offering two methods:

- Tracking with an existing number and carrier.
- Using a Tracker included with an EasyPost-purchased shipping label.

The service integrates webhooks for timely shipment updates. For detailed information on
tracking methods, visit the Tracking Guide.

Related:

- [Trackers Documentation](https://docs.easypost.com/docs/trackers)
- [Trackers Guide](https://docs.easypost.com/guides/tracking-guide)

---

## Additional Resources

### Carrier Metadata

The Carrier Metadata endpoint can programmatically return information about service
levels, predefined packages, supported features, and shipment options.

Use this information to quickly integrate and make educated decisions about the mix of carriers for shipping needs. Additionally,
the Carrier Metadata endpoint is available to retrieve comprehensive information about
all carriers on the EasyPost platform, enhancing decision-making for carrier services.

### Support and Troubleshooting

In addition to the guidance provided in our Carrier Guides, EasyPost offers support to assist with FAQs, troubleshooting issues, and inquiries related to the EasyPost platform.

Please visit the Help Center for more information.

Related:

- [Carrier Metadata](https://docs.easypost.com/docs/carrier-metadata)
- [Help Center](https://support.easypost.com/hc/en-us)

---

## Talk to a Shipping Expert

For questions about getting started with the EasyPost API please talk to a Shipping Expert or Contact Support.

Related:

- [Talk to a Shipping Expert](https://www.easypost.com/talk-to-easypost)
- [Contact Support](https://support.easypost.com/hc/requests/new)