Skip to main content


This query returns the Application with the given unique name.

Learn more about Applications.



Nullable Application

The Application object.

Propel Applications represent the web or mobile app you are building. They provide the API credentials that allow your client- or server-side app to access the Propel API. The Application's Propeller determines the speed and cost of your Metric Queries.

Learn more about Applications.

  • non-null ID

    The Application's unique identifier.

  • applicationByName.uniqueName non-null String

    The Application's unique name.

  • applicationByName.description non-null String

    The Application's description.

  • applicationByName.account non-null Account

    The Application's Account.

  • applicationByName.environment non-null Environment

    The Application's Environment.

  • applicationByName.createdAt non-null DateTime

    The Application's creation date and time in UTC.

  • applicationByName.modifiedAt non-null DateTime

    The Application's last modification date and time in UTC.

  • applicationByName.createdBy non-null String

    The Application's creator. It can be either a User ID, an Application ID, or "system" if it was created by Propel.

  • applicationByName.modifiedBy non-null String

    The Application's last modifier. It can be either a User ID, an Application ID, or "system" if it was modified by Propel.

  • applicationByName.clientId non-null String

    The Application's OAuth 2.0 client identifier.

  • applicationByName.secret nullable String

    The Application's OAuth 2.0 client secret.

  • applicationByName.propeller non-null Propeller

    The Application's Propeller.

    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

  • applicationByName.scopes non-null array of ApplicationScope

    The Application's OAuth 2.0 scopes.

    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.

  • applicationByName.policies non-null PolicyConnection

    A paginated list of Policies associated with the Application.