Authentication

Step 1. Request a client_id and client_secret from FutureVault

Step 2. Call FutureVault's authentication API using the client_id and client_secret to request an access token

Step 3. Use the access token to access any of FutureVault's APIs

---

Step 1

To access FutureVault's APIs you need to be provided access by FutureVault. Request a client_id + client_secret from FutureVault by filing out the following form. You'll receive an email shortly with your client_id and instructions on how to access the client_secret

Step 2

Use your client_id and client_secret in a request to receive an API Access token via our AUTH API. See a sample below.

Request

$ curl 'https://sandbox-api.futurevault.com/oauth2/token' -i -X POST 
 -H 'Content-Type: application/json' 
 -d '{
  "grant_type":"client_credentials",
  "client_id":"{your_client_id_here}",
  "client_secret":"{your_client_secret_here}" 
}

Response

{
    "access_token": "{token_from_futurevault}",
    "token_type": "Bearer",
    "expires_in": 3600
}

Step 3

Call one of our APIs using an access token (as seen in the response of Step 2 above). See the create vault sample API call below with the access token included as token_from_futurevault used to authenticate your request.

$ curl 'https://sandbox-api.futurevault.com/users/vault' -i -X POST 
  -H 'Content-Type: application/json' 
  -H 'Authorization: Bearer {token_from_futurevault}' 
  -d '{
    "firstname":"firstname",
    "lastname":"lastname",
    "email": "[email protected]",
    "password":"P@ssword1234!",
    "sendActivationEmail" : true 
}

$ curl 'https://sandbox-api.futurevault.com/documents/{docId}/download' -i -X GET 
     -H 'Authorization: Bearer {token_from_futurevault}' 
     -H 'vaultId: {vault_id}'