🇺🇦 Nova Poshta: API key from the account
Branches and door delivery across Ukraine: API key in the My Nova Post account, a test key by phone number, dispatch city, rates in hryvnia.
Where it is set up: Control panel → “Shipments” → “Delivery services” button (or the location card → WEB → “Delivery services”).
What you need#
- a My Nova Post account — for a business under the company or sole-trader (FOP) profile.
Getting the keys in the carrier account#
- Log in to my.novapost.com.
- Open “Integrations → API keys” and create a key.
- Copy the key.
What to enter in the carrier card#
| Field | What to enter |
|---|---|
| API key | the key from the account |
| Dispatch city | the town name — matched to the Nova Poshta directory automatically |
Check#
- Click “Save”.
- Click “Test connection”: rates appear under the card. “Mock mode” means the keys are not connected and the rates are demo.
- Tick “Enable …” in the card — the carrier then appears to buyers at checkout.
Without keys and test mode#
A sandbox test key is issued in the same place, by phone number. Without a key the card shows demo rates.
Common problems#
- Buyers do not see rates — Nova Poshta rates are in hryvnia and are shown only in a shop with UAH currency.
Links#
- Carrier website: https://novaposhta.ua/
- Account: https://my.novapost.com/
- API documentation: https://api-portal.novapost.com/