First steps

In this guide, you will learn how to set up and use the seven API. We'll show you how to use one of our API clients and how to make your first API request. You'll also learn where to go next to find all the information you need to take full advantage of our powerful REST API.

Select your client

Before you make your first API request, you need to select the API client you want to use. In addition to the good old cURL HTTP requests, seven also offers clients for JavaScript, Python, PHP and many other programming languages. The following example shows you how to install the individual clients.

# CURL is most likely already installed on your computer.
curl --version

See our list of SDKs →

Make your first API request

Once you have selected your preferred client, you can make your first call to the seven API. Below you can see how to send a GET request to the "SMS" endpoint to send a message.

curl -X POST https://gateway.seven.io/api/sms \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -d "to=49176123456789" \
  -d "from=AcmeInc" \
  -d "text=hello world"

Read the documentation for the SMS endpoint →

What happens next?

Great, now you have set up an API client and made your first request to the API. Here are some links that you might find useful as you continue to explore the seven API:

• Create your API key
• Sign your API requests
• Receive webhooks for instant updates