# 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 !


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.twake.app/developers-api/get-started/create-your-first-application.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.