TalkingPoints Connector Direct API Integration Guide

We’re excited that you’ve chosen to partner with TalkingPoints via TalkingPoints Connector! TalkingPoints Connector is the TalkingPoints direct integration tool that uses the OneRoster v1.1 data spec. Follow the steps below to get started.

Step 1: Share the following with the TalkingPoints team:

Step 2: You will receive an email from noreply@us-east-1.rosterstream.com. Click on 'Setup Connection' and log in using the verification code.

Step 3: Generate your password.

Step 4: Fill in your API endpoint (SIS-based URL).

Step 1: TalkingPoints will initiate a sync on the direct API connection to begin filling in basic roster data (this data is SIS-specific).

Step 2: Schedule a supplemental .csv home language file to run nightly to the TalkingPoints Connector SFTP server. This file should have two columns: guardian IDs and home language.

TalkingPoints accepts either fully spelled-out languages (English, Spanish, French) OR we accept the ISO 639-1 codes (en, es, fr). If your data is in an unsupported format, the TalkingPoints team will work with you to help map the data to the necessary format.

Optional: You may choose to schedule an optional ELL status file to run nightly to the TalkingPoints Connector SFTP server. This file should have two columns: student ID and ELL status.

Step 3 (SIS-dependent): Depending on your SIS, you may need to schedule additional supplemental .csv files such as users.csv and staffroles.csv.

The TalkingPoints team will review to ensure that all data required is present and initiate the TalkingPoints instance creation. Once the site is created, the TalkingPoints team will notify you and your team.

Step 1: Log into TalkingPoints at https://app.talkingpts.org/districts using your preferred sign-in method to verify your data.

Step 2: Work with your TalkingPoints Partner Success Manager on the TalkingPoints rollout plan for your school or district.