The Loop API uses API keys to authenticate requests. You can view, edit, and create API keys from the Developers page in the Loop Admin.
API endpoints require keys with specific scopes. Ensure you create API keys with the necessary scopes for the specific endpoints you plan to use. Refer to the documentation for each endpoint to determine the required scopes.
If the API key you are using does not have the required scope, you will receive a 401 Unauthorized response.
API Key Scope Quick Reference:
| Scope | Available Endpoints |
|---|---|
| Returns | Process Return, Remove Line Items, Cancel Return, Flag Return, Close Return, Get Return Notes, Create Return Note, Detailed Returns List, Get Return Details, Advanced Shipping Notice |
| Orders | Create Return Deep Link, Create Return Deep Link with QR Code, List All Blocklist Items, Get Blocklist Item, Create Blocklist Item, Delete Blocklist Item, List All Allowlist Items, Get Allowlist Item, Create Allowlist Item, Delete Allowlist Item |
| Carts | On-store, On-store Snippet |
| Developer Tools | Get, Create, Update, and Delete Webhooks |