All pages
Powered by GitBook
1 of 1

Loading...

Provision Family plans via API

API access to creating free family plans associated to a business account

Note: This API is for partners of Keeper and Enterprise customers deployed in the Keeper Security Government Cloud region.

Overview

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

Capabilities of the API

Provision Family Plan API endpoint is for enterprise accounts & MSP partners to register Keeper Family licenses. This endpoint will create a 1 year license with the following Product/Add-ons:

  • Keeper Family

  • BreachWatch (Dark Web Monitoring)

  • 10GB File Storage

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

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

API definition

Additional API details

API Parameters

For more information on the required parameters, visit:

API Response codes

For more information on the response codes, visit:

API Explorer

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

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

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

Sample node.js script

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

page
API Parameters
API Response Codes
swagger editor
4KB
FamilyPlan.yaml
Open
API Explorer - Swagger
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?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);
  });
get

This is an API endpoint for partners to register Keeper Family licenses.This endpoint will create a 1 year license with the following Product/Add-ons -- Keeper Family,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 )

partner_namestring · min: 1Required

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

Responses
200

OK

application/json
400

Bad Request

application/json
401

Unauthorized

application/json
get
/create-license
{
  "success": true,
  "order_number": "12345678-1234",
  "vault_url": "dev.keepersecurity.com/vault/#"
}
GET /bi_api/v1/services/partner/create-license?transaction_id=text&first_name=text&email=text&hash=text&partner_name=text HTTP/1.1
Host: keepersecurity.com
Accept: */*