Add a Nova Post account

Required roles:

AdminAccount Manager

Updated June 20, 20264 min read EuropePostal novapost.com

This guide walks through setting up a Nova Post account in the Carriyo Dashboard. It covers the required roles, the credentials to collect, and every field Nova Post expects.

At a glance

Cross-border

International

Returns

Supported

Shipping rates

Not supported

Document upload

Not supported

Real-time status

Polling only

Labels

PDF

Before you start

A Nova Post account in good standing, plus its API credentials. The required fields are listed in All Nova Post settings below.
Decide the account country and the default service and label format this account uses.

Open the carrier accounts page

In the Carriyo Dashboard, open Settings in the left sidebar. Under Carrier Management, choose Carrier Accounts, then click the + add icon to start a new account.

Pick Nova Post

In the carrier picker, search for Nova Post and click Select. Carriyo creates a Nova Post account and opens the credential step.

Enter the basics

The first wizard page collects two fields:

Account name: A label that's meaningful to your team (e.g. Nova Post Ukraine). Keep it short and unique.
Account country: The country this account ships from. Determines the routes and services available.

Fill in the account name and country.
1Account Name
2Account Country

Enter your Nova Post account details

Enter the required Nova Post account details, then click Next. Every field is documented in All Nova Post settings below, with examples and accepted values.

Fill in the Nova Post account details.
1Incoterm
2Export Reason
3Packing Type
4Cargo Category

Configure the account

The new account opens on its detail page. General settings work the same way for every carrier: the Active toggle, default label and service, and currency. See Add a carrier account for the full reference to these shared settings — default label, merchant access, going live, and common mistakes.

Merchant access

On multi-merchant tenants, restrict the account to specific merchants via the Permissions tab, then Save.

All Nova Post settings

Every field Nova Post exposes in the carrier account, grouped by section. Carriyo stores secrets encrypted and never shows them after saving.

Authentication

1 field

Account identifiers and API credentials used to connect to the carrier.

Field	Type	What to enter
API KeyRequired	Text	API key used to authenticate all Nova Post requests. Obtain it from your Nova Post account manager. Example: `472qrqr29588p254op735o096p0069q3`

Account Details

9 fields

Account-level configuration and defaults applied to shipments.

Field	Type	What to enter
Payer TypeOptional	Select	Party responsible for paying the shipping charges. SenderRecipientThird Person
Payer Contract NumberOptional	Text	Nova Post contract number to bill, required when the payer is a third person. Example: `9876`
IncotermRequired	Select	Incoterm determining who bears duties and taxes on cross-border shipments. Example: Delivered at Place Delivery Duty PaidDelivered at Place
Export ReasonRequired	Select	Reason for export declared to customs on international shipments. Example: `Selling` For Personal PurposesSellingRepairReturnOther
Packing TypeRequired	Select	Default packaging used when booking shipments. Example: `Box` BoxPallet
Cargo CategoryRequired	Select	Default cargo category classifying the shipment contents. Example: `Parcel` ParcelDocumentsCargo
Default Parcel DescriptionOptional	Text	Fallback goods description used when a shipment has no item description. Example: e.g. Clothing and accessories
Dropoff Shipments At Nova Post WarehouseOptional	Toggle	Enable if you drop parcels off at a Nova Post warehouse instead of arranging pickup.
Nova Post Division IdOptional	Text	Identifier of the Nova Post warehouse (division) where parcels are dropped off. Example: `67810`

Reference Mappings

1 field

Map Carriyo fields to the reference values the carrier expects.

Field	Type	What to enter
Nova Post Client Order ReferenceOptional	Select	Carriyo reference field to send as the client order reference on Nova Post shipments. Example: Order Reference Order ReferenceShipment Reference

Label

2 fields

Format and type of the shipping label returned by Nova Post.

Field	Type	What to enter
Label FormatRequired	Select	Paper size of the generated shipping label. Example: `size_100_100` size_100_100size_A4
Label TypeRequired	Select	Type of label to generate; use international for cross-border shipments. Example: `international` markinginternational

Capability notes

Behavior that follows from Nova Post's capabilities. Read these before you go live.

Status via polling

This carrier has no push callback. Carriyo polls on a schedule, so tracking can lag the carrier's own system by a few minutes.

No rate API

Carrier Shipping Rates has no effect here. Attach a costing profile to set the shipment cost.

Next steps

Manage account settingsLabels, services, and the Active toggle.Set up costing profilesOverride carrier rates with your own.Add a custom carrierConnect a private fleet or unlisted carrier.Browse all carriersCompare capabilities across the directory.

Was this page helpful?