Getting Started

this guide will provide you with the basic steps to start using the throughline api and incorporating helpline data into your website or application register your account to use the api you first need to sign up for a throughline developer account this account is used to manage your applications and retrieve the api keys needed to access the api don't have an account? sign up here once you have registered and your account has been enabled by one of our team, you'll have access to the throughline developer dashboard please make sure you have read and understood the sandbox terms & conditions (terms) and our usage policies before you start using the api create an application the developer dashboard is your management portal for your developer account to make authorized requests to the api you will need to create an application to manage your application secrets the steps to create an application are as follows log in to the developer dashboard navigate to applications click create application provide a name and select either sandbox or production as the tier of application see the sandbox vs production docid\ ociofkh07nsqxuxn vlry article for more details on the differences save the changes once you have an application you will be able to view your application credentials which are used to authenticate with the api keep your secrets safe! please safeguard your application secret do not share your client secret value with anyone, and do not pass it in the url when making api calls, include it in url query string parameters, or post it in support forums, chat, etc the secret is required to authenticate to the api and generate the tokens required to make valid calls to the api see our api security docid\ ker6xzb7zaobvrzkp9i3l article for best practices in keeping your calls to the api secure throughline reserves the right to revoke any application credentials at any time and issue a new one if they have been leaked or misused call the api the throughline api is secured using oauth 2 0 making calls to the api requires a preliminary authorization step to obtain a valid access token access tokens are required for all requests, and can be included by adding authorization bearer #{access token} as a header once you have an access token, try it out using our api reference documentation to make a call to the /helplines docid\ ejuc4dk2v562k fuduwez endpoint with a bearer token using a third party tool like postman , follow these steps create a new get request in postman set the authorization to bearer token and enter the access token you've obtained add a parameter for the country code this should be the iso 3166 alpha 2 code for the country e g us run the request to see the response postman authentication example see the authorization docid\ pfc 6apw xylscbqqwlu4 article for more on how to obtain an access token for your application and securely access the api getting help if you need integration or technical support, please reach out to our engineering team at engineering\@throughlinecare com