JS SDK: Register New Partner Applications via Form

Call kiflo('partner', ...) each time a prospective partner submits your partner application form. Kiflo creates a partner record in your account and places the new partner into the program level you specify, so your team can immediately review their application and move them through your onboarding workflow. This is the recommended approach if you want partners to apply directly from your marketing site or partner portal.

Syntax

kiflo('partner', {
  // partnerObject
},
function(response) {
  // handle success
},
function(error) {
  // handle error
});

Example

kiflo('partner', {
  name: 'Acme Corp',
  status: 'Prospect',
  programLevelId: 14,
  mainContact: {
    firstName: 'Jane',
    lastName: 'Smith',
    email: 'jane.smith@acme.com',
    jobTitle: 'CEO',
    createAccount: false
  },
  properties: {
    country: 'US'
  }
},
function(response) {
  // handle success
},
function(error) {
  // handle error
});

Parameters

PartnerObject

string

required

The display name of the partner organization — typically the company name (e.g., "Acme Corp").

object

required

The primary contact person for this partner. firstName, lastName, and email are required.

Show MainContact fields

string

required

The contact’s first name.

string

required

The contact’s last name.

string

required

The contact’s email address. This is used to identify the contact in Kiflo.

string

The contact’s job title (e.g., "CEO", "Partnerships Manager").

string

The contact’s phone number in any format (e.g., "+1 555 666 777").

boolean

Set to true to automatically create a Kiflo portal account for this contact, giving them access to the partner portal immediately. Defaults to false.

string

The initial status of the partner record. Accepted values are "Applicant", "Prospect", "Active", and "Declined". Use "Applicant" for partners submitting an application form so your team knows the record needs review.

number

The identifier of the program level the partner is applying to join. See Finding the programLevelId below.

object

Custom partner properties as configured in your Kiflo account properties. Use this to capture any additional data your application form collects, such as country, website, or partnerType.

Finding the programLevelId

The programLevelId is the numeric ID of a specific level within one of your Kiflo programs. To find it:

Log in to your Kiflo account.
Navigate to the program that contains the level.
Click on the level you want partners to apply to.

Look at the browser address bar — the URL will look like:

https://app.kiflo.com/account/65758263/programs/93/levels/155

The last number in the URL is the programLevelId. In this example it is 155.

If your application form lets partners choose between multiple program levels (e.g., “Sales Partner”, “Reseller”), populate a dropdown with each level’s name and corresponding ID, then pass the selected value as programLevelId when the form is submitted.

Full form integration example

Here is a complete example connecting an HTML application form to Kiflo:

function signUpPartner() {
  var firstname      = document.getElementById('firstname').value;
  var lastname       = document.getElementById('lastname').value;
  var email          = document.getElementById('email').value;
  var companyName    = document.getElementById('companyName').value;
  var country        = document.getElementById('country').value;
  var programLevelId = document.getElementById('programLevelId').value;

  kiflo('partner', {
    name: companyName,
    status: 'Applicant',
    programLevelId: programLevelId,
    mainContact: {
      firstName: firstname,
      lastName: lastname,
      email: email
    },
    properties: {
      country: country
    }
  },
  function() {
    console.log('Partner application submitted successfully.');
    window.location.href = '/thank-you';
  },
  function(err) {
    console.error('Partner signup error:', err);
  });
}

After submission, the new partner appears in Kiflo under the program level you specified and is ready for your team to review.

​Syntax

​Example

​Parameters

​PartnerObject

​Finding the programLevelId

​Full form integration example

Syntax

Example

Parameters

PartnerObject

Finding the programLevelId

Full form integration example