> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refold.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# From Scratch
> Create a custom app by performing setup from scratch
To create a custom app from scratch, click on `+ Add App` in the **Custom Apps** section of Refold, choose `+ Create from Scratch` and specify **Name**, **Description** and **Slug** to identify the app within the Refold platform and click on `Create`.
## Authentication Methods
Custom Apps support multiple authentication methods. To setup the Authorization for the Custom App, navigate to `Authorization` in the App and choose the desired method.
The methods of **Authorization** are:
If the Custom App requires API Key based authentication, select `Key Based`. It requires users to set up an API for generating access tokens.
Follow the steps below to setup your custom app:
Select either of **Basic Auth**, **Bearer Token** or **API Key** as the auth mechanism.
Add the input fields that will be visible to your users asking for the required API credentials and click on `Save`.
Once you have added the required user input fields, map those fields now to setup auth data.
Provide the Base URL of the API endpoints for the custom app and the key code for Invalid API Credentials.
Optionally, you can also provide an endpoint which will be called to perform validation of the provided credentials.
Its recommended to provide a GET API endpoint to perform validation, so as to avoid modifying any data using the credentials.
Congratulations!
You have successfully setup a Key based Custom Application in Refold.
If you want to provide OAuth 2.0 type authorization, select `OAuth 2.0` in the methods.
Follow the steps below to configure OAuth mechanism for your custom app:
Add the **Client ID**, **Client Secret** and the **Scopes** of the developer OAuth 2.0 app that you have created.
Ensure that you add the provided `Callback URL` in your developer OAuth 2.0 app.
Add the Authorization and Token URL required for OAuth authentication in the provided fields, select `Client Authentication` type and `Save`.
You can find both the URLs from the Authentication documentation of the custom app that you are setting up.
In the `API Setup` section, provide the **Base URL** for the APIs and appropriate code i.e. **Expired Access Token Codes** which is received on token expiry for the Refresh mechanism to work.
In the `Auth Tokens Data` section, you will provide the mapping using which the tokens can be extracted once received on callback on successful authorization.
Usually an object is received after authorization which will be saved as `access_token_response` on Refold's end and you need to provide the key mapping of the required fields from the object.
Optionally, you can also provide an endpoint which will be called and used to set a field from the API response to use as an identifier for the user.
Its recommended to provide a GET API endpoint to perform validation, so as to avoid modifying any data using the credentials.
Congratulations!
You have successfully setup a OAuth 2.0 Custom Application in Refold.
Select this option if no authentication is required for accessing the custom app.
## Custom Actions for App
Custom Apps support the addition of Actions of APIs.
#### Create Custom Action
Select `Custom Actions`, click on the `New Action` button and provide a **Name** and **Description**.
Add any required or optional **Fields** for the API and add the API under `API Call` section.
Provide the API by breaking it into 2 parts i.e. Base URL and the Endpoint.
#### Enable Pagination for Custom Action
If the Action's API supports pagination, then you can add it to the custom action. Go to the **API Call** section and enable the `Pagination` toggle.
In the `Type` field, select the pagination type and provide the required fields and click on `Save API Call`.
