> ## Documentation Index > Fetch the complete documentation index at: https://docs.genuka.com/llms.txt > Use this file to discover all available pages before exploring further. # Create > Create This endpoint allows developers to **create a new application** on Genuka.\ When creating an app, you must provide the following details: ### Parameters * **Application Name**\ A unique and descriptive name for your application. This name will appear in the developer dashboard and may also be visible to end-users when requesting permissions. * **Description**\ A short summary of what your application does and how it will use the Genuka API. This helps the Genuka team review your request and helps users understand the purpose of your integration. * **Public URL**\ The official website of your application. This should be a valid URL where users can learn more about your app. For example, it might be your product’s homepage or landing page. * **Support Email**\ An active email address that users can contact if they experience issues with your app. This is also used by the Genuka team for communication during the review and approval process. * **Redirect URL**\ The URL where users are redirected after open app on Genuka. * **Callback URL**\ The endpoint in your application that will handle authentication responses from Genuka. Typically, this is where your app exchanges the authorization code for an access token. * **Scopes**\ A list of permissions your application is requesting (e.g., access to user profile, email, or other resources). Each scope should be strictly necessary for your integration to function. Requesting unnecessary scopes may cause your app to be rejected during the review. * **Webhook Endpoints (optional)**\ If your application needs to receive real-time updates from Genuka (e.g., when a product’s is created or a user updates their account), you can provide one or more webhook URLs. These endpoints must be secure and publicly accessible. *** Would you like me to also add an **example request/response** (in JSON) for this endpoint so it looks like a full API reference? ## OpenAPI ````yaml POST /2023-11/developer/apps openapi: 3.0.3 info: title: Genuka V2 - API version: 1.0.0 contact: {} servers: - url: https://api-staging.genuka.com - url: https://api.genuka.com security: - bearerAuth: [] tags: - name: Public Routes - name: Pages - name: Collections - name: Shops - name: Products - name: Articles - name: Discounts - name: Blogs - name: Company - name: Review description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Private Routes - name: Authentication - name: Apps - name: Accounting - name: Addresses - name: Customer - name: Analytics - name: Articles1 - name: Availabilities - name: API Keys - name: Orders - name: Bills - name: Blogs1 - name: Calendar Events - name: Collections1 - name: Company1 - name: Customers - name: Deliveries description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Discount - name: Domains description: |- ``` json { "domain": "", "company_id": "" } ``` - name: Analytics1 - name: Orders1 - name: Payments - name: Pages1 - name: Production - name: Bill of Materials - name: Payments1 - name: Payments Methods - name: Workflows - name: New Folder - name: Wallet - name: Marketing - name: Campaigns - name: Templates - name: Products1 - name: Product Variants - name: Analytics12 - name: Services description: >- Services are "Products" that have a duration in minutes, a buffer time and a list of users able to provide the service. - name: SupplierProducts - name: Shops1 description: >- Shops are sort of subsidiary of companies. A Company can have many Shops. Each shop can have 0 or more . But all of them are properties of a Company. - name: Warehouses description: >- Warehouses are places where stocks are placed. Shop which are physical or virtual point of sales can be attached to one or many warehouses to take their products. - name: Stocks description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Review1 description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: ReviewCriterion description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: StockMovements description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Suppliers - name: Treasury Accounts description: Comptes de trésorerie - name: Users - name: Wrapped - name: Returns - name: Webhooks - name: Customer Routes - name: Authentication1 - name: Addresses1 - name: Orders12 - name: Payments12 - name: Review12 description: |- ``` json { "title": "", "quantity": "", "product_variant": "", "date": "", "company_id": "", "shops": [] } ``` - name: Developer Routes - name: Authentication12 - name: Apps1 - name: Apps Shortcut - name: Products12 description: Developer can access a company product through its app paths: /2023-11/developer/apps: post: tags: - Developer Routes - Apps1 summary: Create description: Create operationId: create27 parameters: - name: x-company in: header schema: type: string example: '{{DeveloperCompanyId}}' requestBody: content: application/json: schema: type: object properties: callback_url: type: string example: http://localhost:3001/api/callback description: type: string example: Create you website from some starter templates medias: type: array items: type: object properties: collection_name: type: string example: logo src: type: string example: '' example: - collection_name: logo src: '' name: type: string example: Genuka Templates privacy_policy_url: type: string example: https://genuka.com/privacy-policy redirect_url: type: string example: http://localhost:3001 scopes: type: array items: type: string example: customer.* example: - customer.* - company.* - products.* support_email: type: string example: demo@genuka.com terms_of_service_url: type: string example: https://genuka.com/terms webhook_url: type: string example: http://localhost:3001/api/webhook examples: Create: value: callback_url: http://localhost:3001/api/callback description: Create you website from some starter templates medias: - collection_name: logo src: '' name: Genuka Templates privacy_policy_url: https://genuka.com/privacy-policy redirect_url: http://localhost:3001 scopes: - customer.* - company.* - products.* support_email: demo@genuka.com terms_of_service_url: https://genuka.com/terms webhook_url: http://localhost:3001/api/webhook responses: '200': description: '' security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ````