Skip to main content


Creates a new Application and returns the newly created Application (or an error message if creating the Application fails).

Learn more about Applications.


  • input required createApplicationInput

    The fields for creating an Application.

    • input.uniqueName optional String

      The Application's unique name. If not specified, Propel will set the ID as unique name.

    • input.description optional String

      The Application's description.

    • input.propeller optional Propeller

      The Application's Propeller. If no Propeller is provided, Propel will set the Propeller to P1_X_SMALL.

      A Propeller determines your Application's query processing power. The larger the Propeller, the faster the queries and the higher the cost. Every Propel Application (and therefore every set of API credentials) has a Propeller that determines the speed and cost of queries.

      Learn more about Data Sources.

      • P1_X_SMALL

        Max records per second: 5,000,000 records per second

      • P1_SMALL

        Max records per second: 25,000,000 records per second

      • P1_MEDIUM

        Max records per second: 100,000,000 records per second

      • P1_LARGE

        Max records per second: 250,000,000 records per second

      • P1_X_LARGE

        Max records per second: 500,000,000 records per second

    • input.scopes optional array of ApplicationScope

      The Application's API authorization scopes. If specified, at least one scope must be provided; otherwise, all scopes will be granted to the Application by default.

      The API operations an Application is authorized to perform.

      • ADMIN

        Grant read/write access to Data Sources, Data Pools, Metrics and Policies.


        Grant read/write access to Applications.


        Grant read access to query Data Pools.


        Grant read access to fetch column statistics from Data Pools.


        Grant read access to query Metrics.


        Grant read access to fetch Dimension statistics from Metrics.


        Grant read access to Metrics.

        This does not allow querying Metrics. For that, see METRIC_QUERY.


Nullable ApplicationOrFailureResponse

The result of a mutation which creates or modifies an Application.

If successful, an ApplicationResponse will be returned; otherwise, a FailureResponse will be returned.