RateTell

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

  1. Visit Canada Post Developer Program
  2. Click "Register"
  3. 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

  1. Log into RateTell dashboard
  2. Go to SettingsCarriers
  3. Click "Add Carrier"
  4. Select "Canada Post"
  5. Enter credentials:
    • API Key: From Canada Post
    • API Password: From approval email
    • Customer Number: Your account number
    • Contract ID: Your contract identifier
  6. Enter Origin Postal Code:
    • Must be Canadian format (A1A 1A1)
    • Include space in middle
  7. Click "Test Connection"
  8. If successful, click "Save"

Testing Your Setup

Test Environment

Canada Post provides test credentials:

  1. Enable "Test Mode" in RateTell
  2. Use test API key from Canada Post
  3. Returns simulated rates
  4. 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