Create an API key
1
Open API & MCP
In EcomWize, open Settings, then API & MCP.
2
Click Create API Key
Click the + Create API Key button in the top right.
3
Name your key
Give your key a descriptive name (e.g., “Production automation” or “Staging tests”).
4
Choose permission
Select the permission level:
- Full access: read, edit, generate with AI (uses credits) and publish
- Read only: read tools and the list and get page endpoints only
5
Copy your key
Your API key is displayed once. Copy it immediately and store it securely. You will not be able to see it again.
Using your key
Include your API key in every request using theAuthorization header:
x-api-key header as an alternative:
Key format
All EcomWize API keys start with theew_live_ prefix followed by 32 hexadecimal characters:
Permissions
If a read-only key calls a write tool or endpoint, the API returns a
403 error. See Tools for which permission each tool needs.
Revoking a key
To revoke an API key:- Go to Settings, then API & MCP.
- Click the … menu on the key you want to revoke.
- Click Revoke Key and confirm.
401 error.
Security
- API keys are hashed before storage. EcomWize never stores your raw key.
- Failed authentication attempts are rate limited to prevent brute force attacks.
- All API requests are logged with timestamps, IP addresses, and status codes for your security.