Quickstart

Make your first Admin API call in three steps: create an app, request a token, and list your products.

Create an app

In the Ecomiq dashboard, open your store and go to Settings → Developers → Create app.

• Under Connection, keep From your server.
• Under Access, pick a template or only the areas your integration needs.

The app only accesses that store. When you save, you see the client_id and client_secret. The secret is shown only once: store it on your server. If you lose it, rotate it from the same screen.

Request a token

Exchange the credentials for a token at Auth:

curl -X POST https://auth.ecomiq.pe/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$ECOMIQ_CLIENT_ID" \
  -d "client_secret=$ECOMIQ_CLIENT_SECRET" \
  -d "scope=api_admin"

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6...",
  "token_type": "Bearer",
  "expires_in": 3600
}

The token lasts expires_in seconds. When it expires, request a new one.

List your products

Send the token in Authorization:

curl "https://api.ecomiq.pe/api/v1/catalog/products?limit=25" \
  -H "Authorization: Bearer $ECOMIQ_TOKEN"

The token already knows which store it works on. To work on another store, create another app there.

Test safely

Every call changes real data. To test:

• Create a test store with its own app. It counts toward your plan's store limit.
• Use manual payment methods so nothing is actually charged.

Admin, Storefront, and Auth accept an app's token. An API key created with POST /v1/api-keys works with none of them.

Next steps

• Authentication: token renewal and OAuth errors.
• ERP integration: products, stock, and orders from your system.
• Admin API: every operation.