{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/elements/account-settings/manage-external-carriers","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/elements/account-settings/manage-external-carriers","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/elements/account-settings/manage-external-carriers","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Manage External Carriers Element","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-external-carriers-element","__idx":0},"children":["Manage External Carriers Element"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Manage External Carriers Element allows users to manage their carrier accounts by displaying connected carriers and providing a list of available shipping carriers for connecting pre-configured accounts within ShipEngine Elements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about External Carrier Connections, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/connect"},"children":["full carrier connection documentation"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can be used as a stand-alone Element and/or utilized within the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/elements/account-settings/account-settings"},"children":["Account Settings Element"]}," via the External Carriers section."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-carriers","__idx":1},"children":["Configuring Carriers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable external carrier connections, you must explicitly list them in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalFeatures.enabledExternalCarriers"]}," array within the features prop when initializing Elements."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DANGER:"]}," ","If you exclude the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalFeatures.enabledExternalCarriers"]}," property, or set the value to an empty array without including any supported carrier codes, users will not be able to view and connect External Carriers in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/elements/account-settings/account-settings"},"children":["Account Settings Element"]}," or the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/elements/account-settings/manage-external-carriers"},"children":["Manage External Carriers Element"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an in depth overview of the global ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["features"]}," object, please review the Configuring Elements Features step in either the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/elements/elements-react#configuring-elements-features"},"children":["ElementsProvider"]}," or the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/elements/elements-sdk#configuring-elements-features"},"children":["Elements SDK"]}," guides."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"supported-external-carrier-accounts","__idx":2},"children":["Supported External Carrier Accounts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["access_worldwide"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["amazon_shipping"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["amazon_shipping_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an_post"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["apc"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["apc_overnight"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["apicode-dpd-local"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["aramex"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["asendia"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["asendia_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["australia_post_mypost_business"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["axlehire"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["b2c_europe"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["better_trucks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["bring_parcels"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["brt_it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["canpar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["castle_parcels"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["chronopost"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["colis_prive"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["colissimo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["couriers_please"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dai"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["delivengo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["deutsche_post_cross_border"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["deutsche_post_dhl"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_ecommerce_au"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_ecommerce_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_express"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_express_australia"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_express_mydhl"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_global_mail"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dhl_parcel_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["direct_freight"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["direct_link"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["doordash_us"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dpd"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dpd_france"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dpd_germany"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dpd_nl"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dpd_poland"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dropoff"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["dx"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["envialia"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["estafeta_mexico"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fairsenden"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fastway_au"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fastway_nz"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fedex"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fedex_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["flashbox"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["fleet_optics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["gls_france"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["gls_germany"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["gls_us"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["gophr"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["grupo_ampm"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["hermes_germany"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["hermescorp"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["inpost"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["inpost_it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["intelcom_ca"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["intelliquick_delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["landmark_global"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["lasership"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["lettre_suivie"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["linex"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["loomis_express"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["lso"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["metroland"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["mondial_relay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["n9minutos"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["nationex"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["netparcel"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["new_zealand_couriers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["newgistics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ninja_van"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["now_couriers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ontrac"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["packeta"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["packfleet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["parcelforce"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["parcll"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["parxl"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["post_haste"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["posta_slovenije"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["poste_italiane"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["postnl"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["purolator_ca"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["quantium"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["redpack"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["rr_donnelley"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["seko"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["seko_ltl_walleted"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["shipx"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["skypostal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["speedy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["star_track"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["starlinks"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["swyft"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the_delivery_group_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["tnt_australia"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["tnt_uk"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["toll_ipec"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["toll_priority"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["yamato"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["yodel"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"react-component","__idx":3},"children":["React Component"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"jsx","header":{"controls":{"copy":{}}},"source":"import { ManageExternalCarriers, ElementsProvider } from '@shipengine/elements';\nimport { themeConfig } from '../themeConfig';\n\nconst tokenPath = '/path/to/token/endpoint';\n\nconst Foo = () => {\n  const getToken = useCallback(() => {\n    return fetch(tokenPath).then((res) => res.text());\n  }, []);\n\n  return (\n    <ElementsProvider\n      getToken={getToken}\n      themeConfig={themeConfig}\n      onError={handleError}\n      features={{\n        globalFeatures: {\n          // The list of all ShipEngine carriers available to be activated\n          enabledShipEngineCarriers: ['stamps_com', 'dhl_express_worldwide'],\n          // The list of external carriers that are available to be activated\n          enabledExternalCarriers: [\n            'apc',\n            'asendia',\n            'better_trucks',\n            'courierpost',\n            'dpd',\n            'seko',\n            'ups',\n            'yodel',\n          ],\n        },\n      }}\n    >\n      <ManageExternalCarriers.Element isModalFullScreen={true} />\n    </ElementsProvider>\n  );\n};\n","lang":"jsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sdk","__idx":4},"children":["SDK"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"// Creates a new instance of the Elements SDK.\nconst elements = new ElementsSDK(getToken, {\n  onError: (err: Error) => console.error(err),\n  themeConfig: themeConfig,\n  locale: 'en-US',\n  features: {\n    globalFeatures: {\n      // The list of all ShipEngine carriers available to be activated\n      enabledShipEngineCarriers: ['stamps_com', 'dhl_express_worldwide'],\n      // The list of external carriers that are available to be activated\n      enabledExternalCarriers: [\n        'apc',\n        'asendia',\n        'better_trucks',\n        'courierpost',\n        'dpd',\n        'seko',\n        'ups',\n        'yodel',\n      ],\n    },\n  },\n});\n\nconst manageExternalCarriers = elements.create('manageExternalCarriers', {\n  isModalFullScreen: true,\n});\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Args/Props"},"children":["Args/Props"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isModalFullSceen"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["boolean"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["optional"]}," If true the connect carrier form modal will take up the whole screen. Defaults to false."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCarrierConnected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["function"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["optional"]}," An optional callback function to be invoked after the successful connection of a carrier account."]}]}]}]}]}]},"headings":[{"value":"Manage External Carriers Element","id":"manage-external-carriers-element","depth":1},{"value":"Configuring Carriers","id":"configuring-carriers","depth":2},{"value":"Supported External Carrier Accounts","id":"supported-external-carrier-accounts","depth":4},{"value":"React Component","id":"react-component","depth":2},{"value":"SDK","id":"sdk","depth":2}],"frontmatter":{"seo":{"title":"Manage External Carriers Element"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/elements/account-settings/manage-external-carriers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}