Authentication

You'll need to authenticate your requests to access any of the endpoints in the API. In this guide, we'll look at how authentication works. OAuth2 is the recommended way to communicate with our API.

Basic authentication

With basic authentication, you use your username and password to authenticate your HTTP requests. Unless you have a very good reason, you probably shouldn't use basic auth. Here's how to authenticate using cURL:

curl https://api.deepvalue.ie/v1/contacts \
  -u username:password

Please don't commit your password to GitHub!

OAuth2 with bearer token

The recommended way to authenticate with the Protocol API is by using OAuth2. When establishing a connection using OAuth2, you will need your access token — you will find it in the Dashboard under API settings. Here's how to add the token to the request header using cURL:

curl https://api.deepvalue.ie/v1/contacts \
  -H "Authorization: Bearer {token}"

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

Using an SDK

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