The easiest way to integrate with the Correos API

One Sendcloud integration gives your WMS, ERP, or e-commerce backend the Correos API plus 170+ other carriers. Ship with Spain's national postal network across all zones, including the islands, without a separate Correos agreement.

Courier API integration graphic for correos

The easiest way to integrate with the Correos API

One Sendcloud integration gives your WMS, ERP, or e-commerce backend the Correos API plus 170+ other carriers. Ship with Spain's national postal network across all zones, including the islands, without a separate Correos agreement.

Courier API integration graphic for correos

The easiest way to integrate with the Correos API

One Sendcloud integration gives your WMS, ERP, or e-commerce backend the Correos API plus 170+ other carriers. Ship with Spain's national postal network across all zones, including the islands, without a separate Correos agreement.

Courier API integration graphic for correos

Free plan available

Works with your shop

Cancel anytime

Why integrate PostNL through the Sendcloud API?

Why integrate PostNL through the Sendcloud API?

Why integrate PostNL through the Sendcloud API?

Why integrate PostNL through the Sendcloud API?

All of Spain, including Ceuta and Melilla

Ship under Sendcloud's negotiated PostNL rates from day one, or bring your own contract when you're ready.

Postal lockers and zone-based pricing

PostNL's evening windows and 4,500+ service points are available via Sendcloud's REST API, with no separate PostNL API credentials required.

Integrate with 170+ carriers at once

Stop maintaining and integrating different carrier and use one API for all.

GDPR Compliance

We comply with the GDPR rules to protect data and privacy in Europe.

API uptime of 99.99%

Reliable shipping software built on AWS and with top market technologies.

ISO 27001 Certified

The world’s most rigorous standards for information security.

Why integrate PostNL through the Sendcloud API?

All of Spain, including Ceuta and Melilla

Ship under Sendcloud's negotiated PostNL rates from day one, or bring your own contract when you're ready.

Postal lockers and zone-based pricing

PostNL's evening windows and 4,500+ service points are available via Sendcloud's REST API, with no separate PostNL API credentials required.

Integrate with 170+ carriers at once

Stop maintaining and integrating different carrier and use one API for all.

GDPR Compliance

We comply with the GDPR rules to protect data and privacy in Europe.

API uptime of 99.99%

Reliable shipping software built on AWS and with top market technologies.

ISO 27001 Certified

The world’s most rigorous standards for information security.

Why integrate PostNL through the Sendcloud API?

All of Spain, including Ceuta and Melilla

Ship under Sendcloud's negotiated PostNL rates from day one, or bring your own contract when you're ready.

Postal lockers and zone-based pricing

PostNL's evening windows and 4,500+ service points are available via Sendcloud's REST API, with no separate PostNL API credentials required.

Integrate with 170+ carriers at once

Stop maintaining and integrating different carrier and use one API for all.

GDPR Compliance

We comply with the GDPR rules to protect data and privacy in Europe.

API uptime of 99.99%

Reliable shipping software built on AWS and with top market technologies.

ISO 27001 Certified

The world’s most rigorous standards for information security.

"Sendcloud allows us to connect to a lot of different carriers seamlessly."

Oscar Ziegler

Founder and CEO

-

Hive

"Sendcloud allows us to connect to a lot of different carriers seamlessly."

Oscar Ziegler

Founder and CEO

-

Hive

"Sendcloud allows us to connect to a lot of different carriers seamlessly."

Oscar Ziegler

Founder and CEO

-

Hive

API integration examples

API Integration

See a basic example of an API integration using Python.

Service Point Picker

See how to integrate the Service Point Picker into a custom application.

API integration examples

API Integration

See a basic example of an API integration using Python.

Service Point Picker

See how to integrate the Service Point Picker into a custom application.

API integration examples

API Integration

See a basic example of an API integration using Python.

Service Point Picker

See how to integrate the Service Point Picker into a custom application.

Instantly connect to 170+ couriers Get started now

Free plan available

Works with your shop

Cancel anytime

More than 2,600 five star reviews

Instantly connect to 170+ couriers Get started now

Free plan available

Works with your shop

Cancel anytime

More than 2,600 five star reviews

Where do you start?

Where do you start?

Where do you start?

1. Set up your account

2. Get your free API key

3. Start sending requests to the PostNL API

1. Set up your account

2. Get your free API key

3. Start sending requests to the PostNL API

1. Set up your account

2. Get your free API key

3. Start sending requests to the PostNL API

Questions & answers

Why integrate the Correos API through Sendcloud instead of directly?

Direct Correos integration means handling the mandatory migration from legacy Webservices to Correos ID (REST API), creating a Correos ID account, generating Client ID and Secret, and requesting manual activation from your Correos Sales Manager. Correos no longer issues Webservices credentials to new merchants and the legacy API stops working on February 1st, 2026.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for Correos alongside every other carrier. A direct Correos contract is required either way; Sendcloud rates aren't offered for Correos.

What happens when Correos updates or breaks their API?

Correos is in the middle of a forced API migration: the legacy Webservices retire on February 1st, 2026 and all merchants must move to Correos ID (REST API). Direct integrators have to migrate credentials, request manual activation from Correos Sales, and re-test payloads.

When you ship Correos through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering tracks Correos's migration timeline and adjusts the carrier connector internally. Your Sendcloud request schema stays the same regardless of which Correos backend is in use.

Can I use my own Correos contract?

Yes, and you have to. Correos requires a direct contract; Sendcloud rates aren't offered.

Use Correos ID (REST API) credentials. Create a Correos ID account, generate your Client ID and Client Secret, ask your Correos Sales Manager to manually activate them, and ensure your Correos ID is linked to your Correos contract. In Sendcloud, go to Shipping > Carriers > My Contracts, find Correos, click Add Contract, and enter Correos ID, Correos ID Secret, customer number, contract number, labeller code, and (optional) IBAN for cash-on-delivery.

See the Correos contract activation Help Center article.

Which Correos products are supported through the API?

Through Sendcloud, you can ship Correos's full domestic product line:

  • Correos Estandar Entrega a Domicilio: standard home delivery up to 30 kg, max 120 cm length, 210 cm girth

  • Service-point and CityPaq locker delivery options

  • Cash-on-delivery (when IBAN is configured on the contract)

  • International shipping through Correos's network

Spanish shipping zones cover Provincial, Regional, Peninsular (mainland Spain plus Andorra), Zone 4 (Balearic Islands, Ceuta, Melilla), Zone 5 (Canary Islands), Zone 6 (inter-island Canary), and Zone 7 (mainland Portugal). See the Correos shipping conditions Help Center article.

Which Correos-specific features does the API expose?

Correos-specific features exposed through the integration:

  • CityPaq locker network for both outbound and return shipments

  • Spanish 7-zone shipping structure built into the rate engine

  • Mailbox and neighbor-delivery options when the recipient is unavailable

  • Cash-on-delivery via IBAN configured on the contract

  • Coverage to mainland Portugal (Zone 7) without a separate carrier

How do I track Correos parcels?

Correos tracking includes CityPaq locker drop-off and pickup events alongside standard home delivery. Mailbox-delivery and neighbor-delivery events also flow through the webhook stream when the recipient is unavailable.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create Correos return labels?

Correos exposes returns through the CityPaq locker network in addition to standard return services. The Sendcloud shipping-methods endpoint returns the methods enabled for your account.

All return labels are created through Sendcloud's standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting carriers individually?

The Sendcloud REST API gives you access to 170+ carriers, including Correos, through one credential set, one schema, one webhook stream, and one error model. Connecting carriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a carrier ships breaking changes upstream.

With Sendcloud, you ship Correos alongside SEUR, MRW, NACEX, and DHL, or any other carrier in your account using the same code. Route shipments between carriers based on rules (weight, destination, service level, cost) without writing carrier-specific routing logic. Fall back to alternative carriers automatically if Correos's upstream system has issues.

Adding a new carrier later means adding it to your Sendcloud account, not building a new integration.

Questions & answers

Why integrate the Correos API through Sendcloud instead of directly?

Direct Correos integration means handling the mandatory migration from legacy Webservices to Correos ID (REST API), creating a Correos ID account, generating Client ID and Secret, and requesting manual activation from your Correos Sales Manager. Correos no longer issues Webservices credentials to new merchants and the legacy API stops working on February 1st, 2026.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for Correos alongside every other carrier. A direct Correos contract is required either way; Sendcloud rates aren't offered for Correos.

What happens when Correos updates or breaks their API?

Correos is in the middle of a forced API migration: the legacy Webservices retire on February 1st, 2026 and all merchants must move to Correos ID (REST API). Direct integrators have to migrate credentials, request manual activation from Correos Sales, and re-test payloads.

When you ship Correos through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering tracks Correos's migration timeline and adjusts the carrier connector internally. Your Sendcloud request schema stays the same regardless of which Correos backend is in use.

Can I use my own Correos contract?

Yes, and you have to. Correos requires a direct contract; Sendcloud rates aren't offered.

Use Correos ID (REST API) credentials. Create a Correos ID account, generate your Client ID and Client Secret, ask your Correos Sales Manager to manually activate them, and ensure your Correos ID is linked to your Correos contract. In Sendcloud, go to Shipping > Carriers > My Contracts, find Correos, click Add Contract, and enter Correos ID, Correos ID Secret, customer number, contract number, labeller code, and (optional) IBAN for cash-on-delivery.

See the Correos contract activation Help Center article.

Which Correos products are supported through the API?

Through Sendcloud, you can ship Correos's full domestic product line:

  • Correos Estandar Entrega a Domicilio: standard home delivery up to 30 kg, max 120 cm length, 210 cm girth

  • Service-point and CityPaq locker delivery options

  • Cash-on-delivery (when IBAN is configured on the contract)

  • International shipping through Correos's network

Spanish shipping zones cover Provincial, Regional, Peninsular (mainland Spain plus Andorra), Zone 4 (Balearic Islands, Ceuta, Melilla), Zone 5 (Canary Islands), Zone 6 (inter-island Canary), and Zone 7 (mainland Portugal). See the Correos shipping conditions Help Center article.

Which Correos-specific features does the API expose?

Correos-specific features exposed through the integration:

  • CityPaq locker network for both outbound and return shipments

  • Spanish 7-zone shipping structure built into the rate engine

  • Mailbox and neighbor-delivery options when the recipient is unavailable

  • Cash-on-delivery via IBAN configured on the contract

  • Coverage to mainland Portugal (Zone 7) without a separate carrier

How do I track Correos parcels?

Correos tracking includes CityPaq locker drop-off and pickup events alongside standard home delivery. Mailbox-delivery and neighbor-delivery events also flow through the webhook stream when the recipient is unavailable.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create Correos return labels?

Correos exposes returns through the CityPaq locker network in addition to standard return services. The Sendcloud shipping-methods endpoint returns the methods enabled for your account.

All return labels are created through Sendcloud's standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting carriers individually?

The Sendcloud REST API gives you access to 170+ carriers, including Correos, through one credential set, one schema, one webhook stream, and one error model. Connecting carriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a carrier ships breaking changes upstream.

With Sendcloud, you ship Correos alongside SEUR, MRW, NACEX, and DHL, or any other carrier in your account using the same code. Route shipments between carriers based on rules (weight, destination, service level, cost) without writing carrier-specific routing logic. Fall back to alternative carriers automatically if Correos's upstream system has issues.

Adding a new carrier later means adding it to your Sendcloud account, not building a new integration.

Questions & answers

Why integrate the Correos API through Sendcloud instead of directly?

Direct Correos integration means handling the mandatory migration from legacy Webservices to Correos ID (REST API), creating a Correos ID account, generating Client ID and Secret, and requesting manual activation from your Correos Sales Manager. Correos no longer issues Webservices credentials to new merchants and the legacy API stops working on February 1st, 2026.

Through Sendcloud, you authenticate once with your Sendcloud API key and use a single REST schema for Correos alongside every other carrier. A direct Correos contract is required either way; Sendcloud rates aren't offered for Correos.

What happens when Correos updates or breaks their API?

Correos is in the middle of a forced API migration: the legacy Webservices retire on February 1st, 2026 and all merchants must move to Correos ID (REST API). Direct integrators have to migrate credentials, request manual activation from Correos Sales, and re-test payloads.

When you ship Correos through the Sendcloud REST API, the abstraction layer absorbs those changes. Sendcloud's engineering tracks Correos's migration timeline and adjusts the carrier connector internally. Your Sendcloud request schema stays the same regardless of which Correos backend is in use.

Can I use my own Correos contract?

Yes, and you have to. Correos requires a direct contract; Sendcloud rates aren't offered.

Use Correos ID (REST API) credentials. Create a Correos ID account, generate your Client ID and Client Secret, ask your Correos Sales Manager to manually activate them, and ensure your Correos ID is linked to your Correos contract. In Sendcloud, go to Shipping > Carriers > My Contracts, find Correos, click Add Contract, and enter Correos ID, Correos ID Secret, customer number, contract number, labeller code, and (optional) IBAN for cash-on-delivery.

See the Correos contract activation Help Center article.

Which Correos products are supported through the API?

Through Sendcloud, you can ship Correos's full domestic product line:

  • Correos Estandar Entrega a Domicilio: standard home delivery up to 30 kg, max 120 cm length, 210 cm girth

  • Service-point and CityPaq locker delivery options

  • Cash-on-delivery (when IBAN is configured on the contract)

  • International shipping through Correos's network

Spanish shipping zones cover Provincial, Regional, Peninsular (mainland Spain plus Andorra), Zone 4 (Balearic Islands, Ceuta, Melilla), Zone 5 (Canary Islands), Zone 6 (inter-island Canary), and Zone 7 (mainland Portugal). See the Correos shipping conditions Help Center article.

Which Correos-specific features does the API expose?

Correos-specific features exposed through the integration:

  • CityPaq locker network for both outbound and return shipments

  • Spanish 7-zone shipping structure built into the rate engine

  • Mailbox and neighbor-delivery options when the recipient is unavailable

  • Cash-on-delivery via IBAN configured on the contract

  • Coverage to mainland Portugal (Zone 7) without a separate carrier

How do I track Correos parcels?

Correos tracking includes CityPaq locker drop-off and pickup events alongside standard home delivery. Mailbox-delivery and neighbor-delivery events also flow through the webhook stream when the recipient is unavailable.

All events normalise to Sendcloud's status taxonomy through GET https://panel.sendcloud.sc/api/v2/tracking/{tracking_number}, with the chronological history under statuses and each event mapped to parent_status. Subscribe to the parcel-status-changed webhook for push updates. Reference: Tracking parcels.

How do I create Correos return labels?

Correos exposes returns through the CityPaq locker network in addition to standard return services. The Sendcloud shipping-methods endpoint returns the methods enabled for your account.

All return labels are created through Sendcloud's standalone v3 Returns API (synchronous or asynchronous; async is recommended for higher throughput). No outgoing parcel lookup or JWT tokens are required. Reference: Returns API overview.

How does Sendcloud's multi-carrier API compare to connecting carriers individually?

The Sendcloud REST API gives you access to 170+ carriers, including Correos, through one credential set, one schema, one webhook stream, and one error model. Connecting carriers individually means handling separate authentication, payload formats, and tracking systems for each, and redoing the work every time a carrier ships breaking changes upstream.

With Sendcloud, you ship Correos alongside SEUR, MRW, NACEX, and DHL, or any other carrier in your account using the same code. Route shipments between carriers based on rules (weight, destination, service level, cost) without writing carrier-specific routing logic. Fall back to alternative carriers automatically if Correos's upstream system has issues.

Adding a new carrier later means adding it to your Sendcloud account, not building a new integration.

One API for all your shipping needs

No setup fees

Same-day integration

Ship with Europe’s top carriers

One API for all your shipping needs

No setup fees

Same-day integration

Ship with Europe’s top carriers

One API for all your shipping needs

No setup fees

Same-day integration

Ship with Europe’s top carriers