Canada Post
How to get Canada Post API credentials and connect to RateTell
Canada Post Credentials
Get API credentials from Canada Post to display live Canada Post shipping rates in your checkout.
What You Need
- Canadian business
- Canada Post business account
- Active contract with Canada Post
- Canadian business address
Step-by-Step Setup
1. Register for Developer Program
- Visit Canada Post Developer Program
- Click "Register"
- Select "Developer Program"
2. Complete Application
Fill out registration form:
- Business Name: Legal business name
- Contact Information: Your details
- Business Address: Canadian address
- Canada Post Customer Number: From your account
- Contract Number: From your shipping contract
Click "Submit Application"
3. Wait for Approval
- Canada Post reviews applications
- Approval takes 3-5 business days
- You'll receive email confirmation
- Check spam folder if no response
4. Receive Credentials
Once approved, you'll get:
- API Key
- API Password
- Customer Number
- Contract ID
5. Add to RateTell
- Log into RateTell dashboard
- Go to Settings → Carriers
- Click "Add Carrier"
- Select "Canada Post"
- Enter credentials:
- API Key: From Canada Post
- API Password: From approval email
- Customer Number: Your account number
- Contract ID: Your contract identifier
- Enter Origin Postal Code:
- Must be Canadian format (A1A 1A1)
- Include space in middle
- Click "Test Connection"
- If successful, click "Save"
Testing Your Setup
Test Environment
Canada Post provides test credentials:
- Enable "Test Mode" in RateTell
- Use test API key from Canada Post
- Returns simulated rates
- Switch to production when ready
Verify Connection
Click "Test Connection" to:
- Validate API credentials
- Check contract status
- Confirm postal code format
- Get sample rates
Troubleshooting
Application Pending: Check spam/junk email or call Canada Post at 1-866-607-6301 after 5 days.
Invalid Contract ID: Find Contract ID in Business Portal → Account Settings (different from Customer Number).
Postal Code Format: Must include space (e.g., "M5H 2N2" not "M5H2N2") and use uppercase.
Postal Code Format Examples
Correct: M5H 2N2, K1A 0B1, V6B 4Y8 Incorrect: M5H2N2 (no space), m5h 2n2 (lowercase), M5H-2N2 (hyphen)
Next Steps
Need help? Email support@ratetell.com or call Canada Post at 1-866-607-6301