Authorization header. Every request you make must include a valid API key — requests without credentials are rejected with 401 Unauthorized. Keys are scoped, so each one only grants access to the resources you explicitly allow.
Getting an API Key
Generate your API key from the Eaglecart admin dashboard. Keep the key you generate safe — you won’t be able to view it again after creation.1
Log in to your admin dashboard
Navigate to https://admin.eaglecart.com and sign in with your store owner or staff account.
2
Open API Keys settings
Go to Settings → Developer → API Keys in the left navigation panel.
3
Create a new API key
Click Create API Key to open the key creation form.
4
Give the key a descriptive name
Enter a name that identifies what this key is used for, such as
My Integration or Order Sync — Fulfillment Provider. This name appears in the audit log so you can trace activity back to the right key.5
Select scopes
Choose only the permissions your integration needs. Available scopes include:
read:orders, write:orders, read:products, write:products, read:customers, read:inventory, write:inventory6
Copy your key immediately
After you click Create, your key is displayed once. Copy it to a secure location such as a secrets manager or environment variable store. Eaglecart does not store the raw key and cannot show it to you again.
Using Your API Key
Pass your API key in theAuthorization header as a Bearer token on every request. Do not include it as a query parameter — header-based authentication is the only supported method.
API Key Scopes
Scopes control which resources and actions your API key can access. Assign only the scopes your integration requires — this limits the blast radius if a key is ever compromised.Authentication Errors
The API returns the following errors when authentication fails:
Check your key’s configured scopes in the Eaglecart admin if you receive a
403 response.
