Authentication

​

When should I use this?

• You are building a backend service or automation
• You already have API credentials (client ID + secret)
• You want to access billing, ecommerce, or credits APIs programmatically

​

Where do I get API credentials?

1. Log in to your IPXO account
2. Open the Integrations page in the portal: 👉 https://www.ipxo.com/portal/integrations
3. Click Create App
4. Give your application a name and select the required scopes
5. Save the app

• Client ID
• Client Secret

🔐 The Client Secret is shown only once. Make sure to store it securely.

​

Prerequisites

• Client ID – created via Portal → Integrations
• Client Secret – created together with the client ID
• Scopes – define which APIs your token can access

• billing
• ecommerce
• credits
• nethub-data

​

Generate Access Token

​

Request: Get an access token

curl 'https://hydra.ipxo.com/oauth2/token' \
  -X POST \
  -d 'grant_type=client_credentials' \
  -d 'client_id={client_id}' \
  -d 'client_secret={client_secret}' \
  -d 'scope=billing ecommerce credits'

​

Response

{
  "access_token": "{access_token}",
  "expires_in": 86399,
  "scope": "billing ecommerce credits",
  "token_type": "bearer"
}

​

Key response fields explained

​

Using the access token

curl 'https://apigw.ipxo.com/ecommerce/public/{tenant_uuid}/cart' \
-H 'Authorization: Bearer {access_token}'