Configure mobile app token lifespan

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • Configure the length of time it takes for the app to time out.

    Before you begin

    Role required: admin

    About this task

    Mobile apps timeout when their associated OAuth token expires. Token lifespans are considered active if the app is in the foreground or if the app is processing a long running task in the background.

    Procedure

    Configure the OAuth entity for a mobile app.
    1. Navigate to System OAuth > Application Registry and open the OAuth entity for the application you want to modify.

      For example, open the ServiceNow Agent record to modify the timeout for your Mobile Agent. To modify the timeout for your Now Mobile app, open the ServiceNow Request record.

    2. In the Refresh Token Lifespan field, change the number in seconds to the amount of time the refresh token is valid.
    3. In the Access Token Lifespan field, change the number in seconds to the amount of time the access token is valid.

    Result

    For example, if you want the mobile app's token to expire after 30 minutes, use the following configuration.
    Configuration point Setting
    Refresh Token Lifespan for the Mobile Agent mobile app or the Now Mobile app 1800 seconds
    Access Token Lifespan for the Mobile Agent mobile app or the Now Mobile app 1800 seconds

    What to do next

    Sign out and sign back in to the mobile app. Otherwise the app uses the previously granted sessions and tokens.