Application Quickstart

Register and configure an application.

Applications are how FreeClimb knows what URLs to request when calls, messages, or status changes happen on the platform. To FreeClimb, an application is simply a set of configuration data.


Register your application

To register an application go to the Apps page in your dashboard.

2770

The dashboard Apps page

Click the "Register New App" button in the upper right hand corner.

Give your application an alias. This is a nickname for your app to make it easy to find.

2770

Give your app an alias in the "Register New App" modal

At this point, you can continue configuration or save your registered application without adding any URLs.

Once you've saved your application an app ID will be generated. You'll see this app ID and the alias in your table of applications.

2768

Table of applications with the newest app added.


Configure your application

Your application's configuration depends on what your app will be doing. Select the application you want to configure from the Apps page in your dashboard by clicking "Edit Config." This will open the app's App Config page where you can configure the following URLs:

WebhookDescription
voiceUrlURL that FreeClimb should request when an inbound call arrives on a phone number assigned to this Application.
voiceFallbackUrlURL that FreeClimb will request if it times out waiting for a response from the voiceUrl.
smsUrlURL that FreeClimb will request when a phone number assigned to this Application receives an incoming SMS message.
smsFallbackUrlURL that FreeClimb will request if it times out waiting for a response from the smsUrl.
callConnectUrlURL that FreeClimb will request when an outbound call request is complete.
statusCallbackUrlURL that FreeClimb will request to pass call status (such as call ended) to the application.

The format for each URL is:

http://www.example.com:PORT/exampleEndpoint

The base and port number of the URL are where your app can be reached. The endpoint is the route you've defined in your code.

Save your app once you've finished configuration.