Create Application

Learn how to create an application with Concur to start collection consents.

An application refers to the software code utilized by a company to deliver services to its customers. This encompasses a range of platforms, including websites, mobile apps, connected TV (CTV) systems, smart TVs, point of sale (POS) devices, and other hardware such as IoT devices, all of which are employed to collect personal data from users.

Prerequisites

Before creating a new application, ensure that you have:

• Completed the developer registration process.

• Ensure that you have .env file with your organization’s ID, key, and secret.

Command

To create a new application, use the following command:

npx let-create-application

This command will initiate the application creation process, where you will be prompted to provide specific details about the application.

Input Parameters

During the execution of npx let-create-application, you will be asked to input the following details in the terminal:

1. Type of Application: Type of your application from below options:

   • web app

   • mobile app

   • ctv (Connected TV)

   • pos (Point of Sale)

   • other

2. Application Name: Provide a unique name for your application.

3. Stage of Application: Specify the current stage of your application:

   • development

   • production

   • testing

4. Application User: Indicate the primary user base or region for your application:

   • global

   • india

   • eu (European Union)

   • usa

   • saudi arabia

Post-Command Updates

1. .env File

After successfully creating the application, the .env file in your project directory will be updated with a new environment variable:

• app_id: This is a unique identifier for the application, which is used in further interactions with Concur’s system.

2. consent-template.yaml File

The command also generates a consent-template.yaml file, which serves as a configuration template for the application. Below is the structure of the generated YAML file:

version: "1.0"
organisation_id: "organisation_id(hexadecimal)"
applications:
  - application_id: "application_id(hexadecimal)"
    type: "web app(Example)"
    name: "flipboo(Example)"
    stage: "development(Example)"
    application_user: "global"
    collection_points: []

File Structure Breakdown:

• version: Specifies the version of the consent template format.

• organisation_id: The unique identifier for your organization (from .env).

• applications: A list of applications managed by your organization, each with the following attributes:

  • application_id: The unique identifier for the application.

  • type: The type of application (e.g., web app).

  • name: The name of the application.

  • stage: The development stage of the application. (e.g., testing)

  • application_user: The primary user base or region for the application. (e.g.,india)

  • collection_points: A list to be populated with points where user data is collected.