Skip to main content

Overview

Global‑e’s API Integration Guides provide detailed documentation to help developers smoothly integrate Global‑e APIs into their systems. Typically, these guides cover authentication methods, API endpoints, request methods and response formats, parameters, examples, and best practices.

Authentication

When initiating calls to the Global-e APIs, ensure that each API request is authenticated using the appropriate authentication method supported by Global-e, as documented in this section.

Authentication: MerchantGUID

To implement API calls with Global-e the only required information is the merchantGUID provided by Global-e. For authentication, make sure to include your Merchant GUID as part of each call or as part of the header so that Global-e can verify your identity. Make sure to use the appropriate merchantGUID, depending on the Global‑e integration environment used for development or production purposes. See Global-e Environments. MerchantGUID in URL Add your MerchantGUID as part of each API URL. MerchantGUID as part of the header Add your MerchantGUID as part of the header as illustrated below.

Rotating Your Merchant GUID

Your Merchant GUID is the credential that identifies your store to Global-e, so it should be treated as a secret and replaced periodically, just as you would rotate any other API credential. Follow the instructions for your platform below to rotate your Merchant GUID: