Creating a New App

Setting up your app is the first step creating a new Asset Layer app and accessing the API. You'll first need to create a HandCash app, and then connect it to your new Asset Layer app.

Step 1: Creating a Handcash App and grabbing the App ID

Creating your first app is extremely simple, but before doing anything on the Asset Layer platform you'll first need to create a Handcash App to link with your Asset Layer App. Get started by logging in to the Handcash Connect Developer Dashboard. Once you are logged in click the "Create App" button shown in the screenshot below

You'll be given the chance to name your app and then taken to a page to manage details for your application. The only setting you need to change to use Asset Layer is to add the Asset Layer extension to your Handcash app. To do this, go to the Extensions menu and click the “+ Add extension” button. Paste in the Asset Layer app ID, 634db6e695a8f2da399ecde3, press enter and you are good to go.

Now that you've added the Asset Layer extension to your app, copy the App ID for your application to your clipboard (shown below) as we'll need this when creating the App in Asset Layer.

Step 2: Creating an Asset Layer App

Now that you've created a Handcash App and copied the Handcash App ID, simply click the "Create New App" button on the Asset Dashboard to get the ball rolling.

You'll then be given the oppurtunity to provide a name for you App along with an input for the Handcash App ID. Simply provide a name for your app and paste the Handcash App ID in the appropriate field.

You'll also have the oppurtunity to provide a thumbnail and description for your app. You can update these fields at any time by navigating to the App Settings menu. After completing the App Details form, click the "Set Default Permissions" button to move on to the next step of the app creation process.

From this page you'll have the ability to set a default setting for read permissions. To learn more about how permissions work, check out our Managing Permissions page. We recommend leaving this setting unaltered for the time being. Once you're satisfied with the setting, hit "Submit App"

After successfully creating your Asset Layer App, we recommend authenticating with HandCash. Doing so will authenticate the HandCash account you are currently using with your new app. This can come in handy when testing the API. To do so, simply click the HandCash App Sign-in link within the developer settings of the app settings menu.

You can also find the link by navigating to the dashboard and click the pop-up icon next to your App's name to view App Details.

Awesome! You're all set and ready to start building your App with the Asset Layer API. You can return to this menu at any time to view details about your application (including App Secret and Asset Layer App ID.