# Create your first application

## Introduction:

This guide will walk you through creating, setting up and installing a Twake application.

## Prerequisites:

* *You are a **manager** of the company.*

## Steps:

### 1. Create a Twake application

![ Fastest way to create an app](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFo003dAxW4oWTVIAkd%2F-MFoHeYbsFMCcmF8vJ6T%2FTwake%20-%20Create%20a%20Twake%20app.gif?alt=media\&token=f5d3ace3-c611-428e-895a-8e0464b2d45c)

1. *Start by opening your `Workspace settings`*
2. *Go to `Applications and connectors`, you should see an **Installed applications area** and **Applications developed by the company**,*
3. *Click on `Access your applications and connectors` then `Create an application`,*
4. *Enter your application name and application group.* 

**Application group** is used to group your application with other applications of the same type. **Be careful, the application group will not be modifiable later.**

### **2. Identity of the application (Optional)**

![](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFoLDDvNsGE1BvV5bJr%2F-MFoT3iRFjNgBqHL7tol%2FTwake%20-%20Identity%20of%20the%20application.gif?alt=media\&token=c9104c5e-65e2-44cf-b3b8-944aeca318c7)

Let's add a description and an icon for our application. \
it will be much prettier! 😇

### 3. API settings

There you will find some important pieces of information:

![](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFoTVQd3nZao1q-PZUc%2F-MFoWXWD4Yjk37hhJPS7%2FTwake%20-%20API%20settings.gif?alt=media\&token=b1eb92fd-420f-4c02-b7ea-161bfe7083b5)

* *Your API private key,*
* *Your public application identifier,*
* *URL that will be used to receive events for your application,*
* *List of IP addresses that have the right to call the Twake API with your credentials. (You can use `*`during the development of your application.)*

**Private key** and **Public application identifier** ​​relate to **calls to the Twake API**.

### 4. Display settings (Optional)

![You can fill your JSON object here](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFoyW9n76DbBaoZNL60%2F-MFoymstR1Jy4AVNOCEL%2FTwake%20-%20%20Display%20settings.png?alt=media\&token=f6e6b8b5-bf3b-4bf7-a6ba-f49a99ae3d5a)

To configure where your application should display, you need to fill a `JSON` object in `Display Settings` field.

[Here](https://doc.twake.app/developers-api/application-settings/application-visibility-example) is a quick example, each field is optional and his presence determines the positioning of your application in Twake.

### 5. Application privileges

![](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFoyW9n76DbBaoZNL60%2F-MFp-XdgFwD0ykYV_p5t%2FTwake%20-%20Application%20privileges.gif?alt=media\&token=575a8766-7ca1-49c4-ae19-4b1400d72e7b)

Your application can access and modify data, only according to your needs you don't need to access all the data present in Twake. \
\
This is why you must specify the accesses for the proper functioning of your application. These accesses will be public and indicated to the user before the installation of your application.

In our example, we will only add  `message_save` and `message_remove` in `Write privileges`.\
\
If you want to know more about capabilities and privileges, take a look at the list [here](https://doc.twake.app/developers-api/application-settings/privileges).

### 6. Install application

Once you've configured your application, you need to install it on Twake. 

![](https://3514651628-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lp7vcxqrLMhIC3gwXlF%2F-MFp4KufQ1B_Bwxl6oHH%2F-MFp6zjm5fwrKyOXARze%2FTwake%20-%20Install%20application.gif?alt=media\&token=05772a14-eeda-49f6-ba88-6a3ec25eab45)

Go to `Applications and connectors`, search and display your application then install it.

Your application is now ready, check the [Authenticate with Postman](https://doc.twake.app/developers-api/get-started/authenticate-postman) documentation for starting using it !