Canada Post Live Rates supports two API connections: REST API through the new Developer Portal and Legacy API through the original Developer Program. Your credentials must match the API Type selected in WooCommerce.
Using the new Developer Portal — REST API
For the new connection, you need a Canada Post business account and an application with access to Rating. Follow How to get the REST API Key and API Secret?
If you already have a Canada Post account, use it to sign in to the new Developer Portal. Existing Legacy credentials do not become REST credentials: obtain the API Key and API Secret from your portal application.
In WooCommerce → Settings → Shipping → Canada Post Live Rates, select API Type → REST API and enter:
- API Key — the application’s OAuth client ID.
- API Secret — the matching OAuth client secret.
- Customer Number — required when requesting Commercial rates.
- Contract ID — your commercial contract number, if applicable. Leave it empty for Solutions for Small Business or a business account without a commercial contract. See the Rating specification.
Use Production application credentials. The plugin obtains OAuth access tokens automatically.
Using the original Developer Program — Legacy API
If you have active Legacy access, select API Type → Legacy API and enter the API Key Username, API Key Password, and Customer Number issued for that system.
The original Developer Program and new Developer Portal use separate credentials. Your Canada Post website username and password are also different from the API credentials.
If you need Legacy credentials and cannot obtain them through your existing Developer Program account, contact Canada Post support and specify that you need access to the legacy Developer Program. For the REST connection, follow the new portal instructions above.
Check the connection
Select Save changes and check API Connection Status. For REST, the connection check uses a sample Counter quote. Review Quote Type in each shipping method and test an actual cart to confirm your rates.
See General Settings or Migrating from Legacy API to REST API.