How to connect CTT v2

Let's see how you can connect CTT to ShippyPro in just a few steps.

1. Before you start
2. Carrier's Configuration
3. Supported services
4. Additional Features
5. Troubleshooting & errors

To connect the carrier, you need to first ask your CTT Sales Person for credentials such as

• Center code

• Client ID

• Client Secret

Do you already have an active CTT connection and want to switch to CTTv2?

If you already have CTT credentials and wish to create a new connection with the CTTv2 version, you’ll need to request new credentials specifically for this integration.

Credentials must be requested by contacting: integracion@cttexpress.com

You can now go in the Carriers page and click on the CTT v2 logo.
Then you can fill the required fields:

• Center code

• Client ID

• Client Secret

• Service

• Label Type

If you can't figure how to do it, try to take a look at the following example:

• C24: CTT 24
• C48: CTT 48
• C14E: CTT PREMIUM EMPRESAS
• C14: CTT 14
• C10: CTT 10
• CCA24: CTT CANARIAS AEREO
• CCAE: CTT CANARIAS DOCUMENTACIÓN
• CCAM: CTT CANARIAS MARÍTIMO
• CBA24: CTT BALEARES EXPRESS
• CBA48: CTT BALEARES ECONOMY
• CIEX: CTT INTERNACIONAL EXPRESS
• CIES: CTT INTERNACIONAL ECONOMY

4. Additional features

Destinations:

• National: ES/PT
• International: Yes but departure must be from ES

Features:

• Label PDF: Available
• Label ZPL: Available
• Label EPL: NO (Specify actual dimension and orientation)
• Track & Trace: Available
• Paperless: NO
• PickUp/DropOff (PUDO): NO
• Cash On Delivery: Available
• Live Rates: NO
• Return Labels: NO
• Return Labels (in the box): NO
• Book/Schedule Pickup: NO
• Address Check: NO
• Proof Of Delivery (POD): NO
• Non-Delivery Options: NO
• Insurance: Available
• Multiparcel: Available
• Delete Shipment (Void): Available
• Closeout: NO
• CN22: NO
• CN23: NO
• Credentials Validation: Available

Besides your credentials, you'll also see some further options, let's take a look at them!

Test Mode lets you make some test shipments.

The "Test Mode" option should be flagged only if you have test credentials, not production ones!

If you want, you can also enter a Custom Label to recognize the connection among all the others.

Internal Server Error

Check if your CTT connection is in Test Mode.

Client error: `POST https://api.cttexpress.com/integrations/manifest/v1.0/shippings` resulted in a `401 Unauthorized` response:
{
"error": "Invalid token."
}

Client error: `POST https://api.cttexpress.com/integrations/oauth2/token` resulted in a `400 Bad Request` response:
{"error": "invalid_client"}

Please check that your credentials are correct.

Is it possible to use ShippyPro for CTT with pickup and returns in Portugal?

The CTT integration currently available in ShippyPro is built on the Spanish endpoint (CTT Express Spain), which is a different provider from CTT Portugal and has its own endpoints, credentials, and services. As a result, a direct contract with CTT Portugal cannot currently be connected to ShippyPro.

In addition, pickup and return services are not currently available for the CTT integration, regardless of the country. All services currently shown in the platform are based on Spain and support domestic shipments as well as selected international destinations.

`POST https://api.cttexpress.com/integrations/oauth2/token` resulted in a `403 Forbidden` response: {"error": {"error_code": 403,"error_date_time": "2026-07-31T06:17:50.561+00:00","error_type": "FORBIDDEN

If you encounter this error message, check your credentials with your CTT representative and request new ones if necessary.