Provision Student plans via API

API access to creating student plans associated to a business account

Note: If you are a student and want a Keeper account, contact your schools IT department, they will need to implement the below API to provision the Keeper account for you.

The primary use case enabled via this API is to provision "Keeper Unlimited" accounts for students within your organization.

Overview

Keeper offers enterprise customers APIs to provision Student plans. Keeper provides REST APIs that enable you to build custom applications and integration in provisioning Student plans.

Capabilities of the API

Provision Student Plan API endpoint is for Universities to register "Keeper Unlimited" accounts for students within your university. The endpoint will create a 1 year license with the following Product/Add-ons:

• Keeper Unlimited

• BreachWatch

• 10GB File Storage

For the full list of Keeper Unlimited License features, visit the following page.

In order to access this API, contact your Keeper representative to request an API key, this will be securely shared in a Keeper record.

API definition

get

This is an API endpoint for partner to register Keeper Unlimited licenses.This endpoint will create a 1 year license with the following Product/Add-ons -- Keeper Unlimited,BreachWatch, 10GB File Storage

Query parameters

transaction_idstring · min: 1Required

Partner Transaction Id (external Id used by the partner as a reference)

first_namestring · min: 1Required

First name of user

last_namestring · min: 1Optional

Last name of user

emailstring · min: 1Required

Email of user

hashstring · min: 1Required

Salted hash, hash = SHA256.hexdigest.bytesToHex(email + salt ), or command line example (echo -n "email+salt" | openssl dgst -sha256)

partner_namestring · min: 1Required

Keeper will provide the expected partner name along with the salt ("secret")

product_typeinteger · min: 4Required

For Student API product type must be equal to 4.

Responses

200

OK

application/json

successbooleanOptional

order_numberstringOptional

Keeper Order Number for reference

vault_urlstringOptional

Link to send to the User to create the vault account with the email used in this API call

400

Bad Request

application/json

401

Unauthorized

application/json

get

/create-license

HTTPcURLJavaScriptPython

GET /bi_api/v1/services/partner/create-license?transaction_id=text&first_name=text&email=text&hash=text&partner_name=text&product_type=1 HTTP/1.1
Host: keepersecurity.com
Accept: */*

{
  "success": true,
  "order_number": "12345678-1234",
  "vault_url": "dev.keepersecurity.com/vault/#"
}

Additional API Details

API Parameters

For more information on the required parameters, visit:

API Parameters

API Response codes

For more information on the response codes, visit:

API Response Codes

API Explorer

If you wish to explore the APIs in another tool like postman or the swagger editor, download the associated YAML definition of the APIs below

4KB

StudentPlan.yaml

Open

For more information on exploring the API with swagger, visit:

API Explorer - Swagger

If you need support or have additional questions on the usage of these APIs, please contact support or your sales representative.

Sample script using the API

Sample node.js script

Use the below sample so understand how you might implement this in your environment:

var request = require('request');
var CryptoJS = require('crypto-js');

var secret = 'PARTNER_SECRET';
var partner_name = 'PARTNER_NAME';
var email = 'EMAIL';
var hash = CryptoJS.SHA256(email + secret);
var transaction_id = 'TRANSACTION_ID';
var first_name = 'FIRST_NAME';
var last_name = 'LAST_NAME';

var options = {
  'method': 'GET',
  'url': 'https://keepersecurity.com/bi_api/v1/services/partner/create-license?product_type=4&transaction_id='+transaction_id+'&first_name='+first_name+'&last_name='+last_name+'&email='+email+'&hash='+hash+'&partner_name='+partner_name+'',
  'headers': {
      'Content-Type': 'application/json'
  }
  };

  request(options, function (error, response) {
      if (error) console.log("Error From the server: "+error);
      console.log("response body: "+response.body);
      console.log("response status: "+response.statusCode);
  });