Context

As part of our continuing focus on building great infrastructure for the Food and Beverage industry we have recently updated our APIs.

Starting from July 2026, there are 2 key changes:

1. Authentication will move from User authentication to token authentication
2. Although backwards compatible, the recommended base URL will change from app.ordermentum.com to api.ordermentum.com

What changes do I need to make?

Instead of sending a Bearer token generated via the v1/auth endpoint, you can now send a x-api-key

The original Ordermentum API had integrations authenticated via "user" accounts.

curl -X POST "https://app.ordermentum.com/v1/auth" \
     -H "Content-Type: application/json" \
     --data '{"username":"[email protected]","password":"hunter2"}'

curl -X GET "https://api.ordermentum.com/v2/orders" \
     -H "Authorization: Bearer YOUR_API_TOKEN"

curl --location 'https://api.ordermentum.com/v2/orders?supplierId=SupplierId' \
		 --header 'x-api-key: om_api*******'

While backwards compatible, we also recommend migrating from app.ordermentum.com to api.ordermentum.com as the base URL.

Where can I get a token?

You can apply for or generate a token via settings -> integrations on the supplier platform.

Reach out to us at [email protected] if you have any questions or need further support.

When do I need to make these changes?

The new token and endpoints will be available from July 2026. We will deprecate the older method starting from January 1st 2027.