Before your application can communicate with the API you will need to create a new API key. The API handles authentication using a signed JSON Web Token (JWT) which is passed in an HTTP header.

curl -X GET https://api.example.gr4vy.app/transactions \
  -H "authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIi..."

We recommend you use an SDK. Our SDKs make the process of generating a token a lot easier and is available in many popular programming languages. We will get to this in the next step.

​
Create a new API key

To use the API you will need to generate a new API key. Head over to your dashboard and visit the Integrations page.

On this page, click the Add API key button and select a name for your key. The name is purely for you to track what key is for what integration. You will need to store the downloaded key securely as we will not store this key for you.

Learn more about API keys and JWTs in our in-depth guide on authentication.

​
Summary

In this step you:

  • Learned about API authentication.
  • Created a new API key for use with the API.
  • Stored this API key in a secure place where your application can access it.