Migrating to KORE's APIs
You must migrate to KORE's APIs by May 1, 2025.
This documentation will explain the differences between interacting with Twilio APIs and KORE. If you have questions, you can reach out to support@korewireless.com.
To learn more about the overall experience KORE offers, dig into our developer docs.
What's Changed?
The request parameters you send to our APIs and the responses you get back have remained unchanged to minimize the work needed to migrate your code for managing Super SIMs and Programmable Wireless SIMs to KORE's REST APIs. For example, you will continue to see the same SIDs (string IDs) on all of your resources.
The biggest challenge you will likely face is switching from using Twilio's static auth tokens and API keys to OAuth workflows if you aren't already familiar with them. Learn more below.
KORE does not have static auth tokens or API keys like Twilio uses. Our APIs are secured using OAuth workflow with expiring access tokens which may require additional development to adopt when migrating. Ensure you account for this in your planning.
Another large change to account for in your planning if you use Twilio's SDKs (aka "helper libraries") today is that KORE does not publish similar prebuilt SDKs. Instead, we publish OpenAPI specification files that you can use to generate clients in whichever languages you use. You can download the latest specification files from our Github.
API Authorization
Twilio's APIs are secured through auth tokens or API Keys, which use HTTP Basic Auth. Regardless of the approach, every API call with Twilio sends the username and password.
KORE's APIs are secured using OAuth 2.0 Client Credentials Flow. You can generate as many API clients as you want. Each API Client will contain API Credentials, a Client-ID and Client-Secret which you use to obtain an expiring token based on the settings you define. You must refresh the token before it expires.
Rotating your API Credentials
With Twilio, you can manage your API Keys and rotate your Auth Tokens through the Twilio Console, specifically the API keys & tokens section of your account.
KORE has a dedicated portal specifically for developers to manage their developer experience with KORE. We call it our Developer Portal, where you generate new API clients and obtain API Credentials to make API calls. Going forward, the developer portal will also be the home to other developer tools, such as managing your webhook secrets and event streams.
KORE uses expiring tokens, which require you to rotate them based on your set expiry time. We have provided examples of how to do it.
Transitioning from Twilio Standard and Main API Keys
With KORE, you can create a Standard API Client, similar to Twilio's Standard Keys, that gives you access to KORE's products' APIs and restricts access to managing global resources like other API credentials and accounts.
You can also create an API client of type Admin, similar to Twilio's Main Keys, that gives you the same access as Standard Keys and allows you to access global resources.
Building Clients from OpenAPI Spec
KORE does not publish prebuilt SDKs. Instead, you can use our OpenAPI specification files to generate clients in whatever programming language you use.
API Reference Documentation
We've migrated our API documentation for Super SIM and Programmable Wireless to KORE. Use these going forward. We will not be making any new updates to the API documentation (or any other documentation) for these products at Twilio.
Get Started!
Here's a high level overview of the steps you'll need to take to begin using KORE's APIs to manage your SIMs:
Log into the KORE Console.
Go to the Developer Portal.
Create an API Client that can access Super SIM, Programmable Wireless, or both.
Save your client ID and secret.
Use your client ID and secret to create an access token.
Use your access token to authenticate to KORE APIs and access your SIMs and related resources.
Head to our developer docs for more details on managing your API integration with KORE. These docs will detail how our APIs respond and some examples of refreshing your tokens.
If you want to dive into our API docs, you can head to the API reference docs.
We suggest you follow our getting started guide to creating your first API Client and calling the PING endpoint, which will familiarize you with KORE's API ecosystem.
Last updated