Authentication

You'll need to authenticate your requests to access any of the endpoints in the OneSend API. In this guide, we'll look at how authentication works.

API-Token authentication

The recommended way to authenticate with the OneSend API is by using the API-Token. You will find it in the OneSend dashboard under API settings. Here's how to add the token to the request header using cURL:

curl https://api.onesend.de/api/short_messages \
  -H "Authorization: ProjectKey {token}"

Always keep your token safe and reset it if you suspect it has been compromised.

Using an SDK

If you use one of our official SDKs, you won't have to worry about any of the above — fetch your access token from the Protocol dashboard under API settings, and the client library will take care of the rest. All the client libraries use OAuth2 behind the scenes.