Skip to content
More support
  • There are no suggestions because the search field is empty.

FACTS Integration Set Up

How to connect your Halda account to your FACTS system.

Create an API Key 

  • The person in your school creating an API Key for a developer must have the Use permission for the API Configuration security item in Security Groups. 
  • The school must have their vendor's Subscription ID to be able to create an API Key for that vendor. • Schools may create multiple unique API Keys for integrating with more than one developer.

  1. From FACTS SIS, click . 
  2. Click System, then click Configuration. 
  3. Click API Configuration, then click API Keys. 
  4. Click Add Key. 
  5. Paste your developer-provided Subscription ID and verify there are no spaces present before or after the character string. 
    1. Halda's Subscription Key is: 38ebb5312eb344dc86f11bd852a870ad
  6. If a space is present, an error may display: Status code = 401 You don't have permission to access this API. 6. Type the developer's name in the API Key Name.
  7. Select which FACTS SIS areas and at what level the developer should have access. Access levels include: None, Read, and Write
  8. Click Generate. The key is generated and displays in a pop-up window.
  9. Click Copy, then send the key to your developer.

Manage access 

  • If you need to modify developer access to any areas, click next to the the Scopes column in your API Configuration list. 

◦ Edit: Change the access level of None, Read, or Write. 

◦ Regenerate key: Create a new key to be shared with a developer. 

◦ Revoke: Remove all access for the developer. 

View activity logs 

  • From the API Configuration screen, click Activity Logs. Listed in the log are: 

◦ Key Name 

◦ Subscription Key 

◦ Endpoint 

◦ Method 

◦ Response Code 

◦ Date 

◦ Details

Finishing The Connection

Once you have generated the API Key, you will plug this into the Halda app.

Log into your Halda account and click the button in the top right corner. Click on "Integrations" and then select "FACTS."

Paste your API Key into the box provided. You will then be able to configure the integration and select what will export to FACTS. You will do this by clicking the "Edit" button next to "Export Leads." 

Mapping Field Values

The following table shows the Halda value and the corresponding FACTS value to map to: 

Halda Value FACTS Value
First Name First Name (ID: 11)
Last Name Last Name (ID: 13)
Email  Email Address (ID: 16)
Phone Number Cell Phone (ID: 14)
Student First Name First Name (ID: 30)
Student Last Name Last Name (ID: 32)
What grade level are you interested in?* Grade Level (ID: 26)
When are you looking to start?* School Year (ID: 28)
Lead Recommendation Parent/Guardian Notes (ID: 8)

*Please note grade level and start year Halda values may vary between forms.