---
title: "Migration Guide"
description: "Migration guide from IBM API Connect to Kong Konnect Dev Portal"
url: "https://api-portal-suitelogi-ppr.stef.com/en/guides/migration"
image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_Migration+Guide,description_Migration+guide+from+IBM+API+Connect+to+Kong+Konnect+Dev+Portal,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9lbi9ndWlkZXMvbWlncmF0aW9uIg,s_nCcrmDcb1n5G0EQZ.png"
---

**Developer Portal**

-   [APIs](https://api-portal-suitelogi-ppr.stef.com/en/apis)
-   [Get Started](https://api-portal-suitelogi-ppr.stef.com/en/getting-started)
-   [Guides](https://api-portal-suitelogi-ppr.stef.com/en/guides)
-   [Support](https://api-portal-suitelogi-ppr.stef.com/en/support)

[FR](https://api-portal-suitelogi-ppr.stef.com/)|**[EN](https://api-portal-suitelogi-ppr.stef.com/en)**|[ES](https://api-portal-suitelogi-ppr.stef.com/es)|[IT](https://api-portal-suitelogi-ppr.stef.com/it)|[PT](https://api-portal-suitelogi-ppr.stef.com/pt)|[NL](https://api-portal-suitelogi-ppr.stef.com/nl)|[DE](https://api-portal-suitelogi-ppr.stef.com/de)

## Migration IBM API Connect → Kong Konnect

This guide walks you through migrating your integrations from the IBM API Connect portal to the new Kong Konnect portal.

## [Summary of Changes](#summary-of-changes)

| Element        | IBM API Connect        | Kong Konnect                |
| :------------- | :--------------------- | :-------------------------- |
| Base URL       | https://api.stef.com/  | https://api.stef.com/       |
| Authentication | Client ID / Secret IBM | OAuth 2.0 / API Key Kong    |
| Gateway        | DataPower              | Kong Gateway                |
| Portal         | Drupal (connect_theme) | Kong Dev Portal v3 (MDC)    |
| Specifications | Swagger 2.0            | OpenAPI 3.0                 |
| Rate limiting  | Plan-based             | Plugin-based (configurable) |

## [Step 1: New Credentials](#step-1-new-credentials)

Your existing IBM API Connect credentials continue to work for already active subscriptions.

However, for any new API subscription, you must:

1.  Create an account on the new portal (if not done yet)
2.  Create a new application
3.  Subscribe to the desired APIs
4.  Retrieve your new credentials (API Key)

Old IBM Client ID and Client Secret no longer work on the new endpoints. Plan a transition period with dual configuration if necessary.

## [Step 2: Error Handling](#step-2-error-handling)

The error format has changed:

### [Old IBM Format](#old-ibm-format)

```json
{
  "httpCode": "404",
  "httpMessage": "Not Found",
  "moreInformation": "Resource not found"
}
```

### [New Kong Format](#new-kong-format)

```json
{
  "status": 404,
  "title": "Not Found",
  "detail": "The requested resource was not found",
  "instance": "/v1/transport/orders/invalid-id"
}
```

## [Migration Checklist](#migration-checklist)

-   [ ]  Create a new account on the Kong portal
-   [ ]  Create an application and retrieve credentials
-   [ ]  Adapt error parsing to the new format

## [Migration Support](#migration-support)

## Need help migrating?

Our support team is available to assist you with your migration. Do not hesitate to contact us.

#### [APIs](#apis)

-   [API Catalogue](https://api-portal-suitelogi-ppr.stef.com/en/apis)
-   [Getting Started Guide](https://api-portal-suitelogi-ppr.stef.com/en/getting-started)

#### [Developers](#developers)

-   [Documentation](https://api-portal-suitelogi-ppr.stef.com/en/guides)
-   [Best Practices](https://api-portal-suitelogi-ppr.stef.com/en/guides/best-practices)
-   [Portals](https://api-portal-suitelogi-ppr.stef.com/en/getting-started/instances)

#### [Support](#support)

-   [Technical Support](https://api-portal-suitelogi-ppr.stef.com/en/support)

#### [Languages](#languages)

-   [Français](https://api-portal-suitelogi-ppr.stef.com/)
-   [English](https://api-portal-suitelogi-ppr.stef.com/en)
-   [Español](https://api-portal-suitelogi-ppr.stef.com/es)
-   [Italiano](https://api-portal-suitelogi-ppr.stef.com/it)
-   [Português](https://api-portal-suitelogi-ppr.stef.com/pt)
-   [Nederlands](https://api-portal-suitelogi-ppr.stef.com/nl)
-   [Deutsch](https://api-portal-suitelogi-ppr.stef.com/de)

© 2026 STEF — All rights reserved

[Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)