1st Flight App Guide

Urban Airship’s ready-to-use 1st Flight app lets you kick the tires (and honk the horn and try the turn signals) immediately. Install the app and send yourself some notifications.

What You’ll Do

In this tutorial, you will:

  1. Create an account on go.urbanairship.com.
  2. Install the 1st Flight app on your iOS or Android mobile device.
  3. Enable the mobile device to receive push notifications. (Using Android? this step is handled automatically for you. Skip to the next step.)
  4. Compose push notifications from go.urbanairship.com, and see them on your mobile device.
  5. Bonus step: Download our Postman Collection and experiment with our API.

Sounds good? Let’s get you set up.


Create an Account

  1. Create an account on go.urbanairship.com.

  2. Enter your email address and hit the Send button, and we’ll send you a magic link you can use to download the app.

Install the App

  1. From your mobile device, check your email for our message, and click the message’s magic link. Your device’s app store will open to the Urban Airship app.

  2. Install and open the app.

Following a magic link syncs your go.urbanairship.com account with the 1st Flight App on your device.

If you downloaded the app from the app store without using a magic link, the first time you open the app you will need to enter your go.urbanairship.com username and password.

Automatically fill in the fields by requesting and following a magic link now.

  • Log in to go.urbanairship.com and choose the 1st Flight app, then you’ll have the option to send yourself a magic link.
  • If you don’t have a go.urbanairship.com account, create one now.

After following the magic link you will return to the same screen but the fields will be populated. Just click the Log in button and you’ll be ready for the next step.

Enable Push Notifications

If you’re using an iOS mobile device, click the Allow button, which allows the device to receive push notifications.

Push is automatically enabled for Android, so this screen will not appear for Android mobile devices.

You’re all set. Let’s send a push notification to your mobile device.

Send a Notification

Compose and send a message, and receive it on your mobile device. We’ll try out a few features along the way, too.

  1. Choose the 1st Flight app from the dashboard, then click the Create button, and select the Message composer.

  2. Select the radio button for All Devices, then click Content in the progress header.
  3. Click the pane for Push Notification, then click the Continue button that appears.

  4. Enter your message in the text field, and you will see it in the previewer to the right.

  5. Select Web Page from the Message Action dropdown menu, then enter a URL. We recommend http://bit.ly/IqT6zt. When your device receives the message and you tap the notification, its web browser will open the URL entered here.

  6. Toggle to enable the Title option. Enter a title in the text field, and notice its position in the previewer.
    Click Delivery in the progress header to move on.

  7. Select the radio button for Send Now, then click Review & Send in the progress header.

  8. Review the information on the left side of the screen, click through the images in the previewer, then click the Send Message button at the bottom of the window.

Take a look at the message as received on your mobile device. Tap the message, and the device’s browser should open the web page defined above.

Try our API

Now that you have the 1st Flight App installed and you have successfully sent yourself a notification through the Urban Airship dashboard, you might want to familiarize yourself with our powerful Engage API.

You can use Postman to try a variety of push notifications using the Urban Airship 1st Flight Postman Collection. After you install Postman, click the Run in Postman link below to automatically import our collection into your Postman account.

Run in Postman


  1. Send more notifications! Our Message Composer documentation walks you through all the features and options.

  2. Integrate Urban Airship with your own app. See: Getting Started.


What can I use the 1st Flight app for?
The 1st Flight app is designed to let you start sending notifications to yourself with a minimum of fuss. Building a sample app or integrating a new SDK into your existing app can take time and involve technical folk who might not be available. We want to make it as easy as possible for you to see the world-leading engage suite Urban Airship provides.
I’m currently on a free plan can I use the 1st Flight app?
Of course! All customers have access to the 1st Flight app. Use any features in the Message Composer and API that are available in your plan other than Message Center and Location History.
Are all message features available in the 1st Flight app?
Unfortunately we don’t currently support Message Center or Location History. All the other notification features included to your plan are available through both the Message Composer and API.
Can anybody else send messages to my installation of the 1st Flight app?
No. The magic link you used to connect your app and Urban Airship account use a unique app key. While other people have their own apps, they will never be able to see or message your device or vice versa.
Will reporting work for notifications I send to the 1st Flight app?
Yes, our push reporting does work for the 1st Flight app.
Does the 1st Flight app only work on phones?
No, the 1st Flight app works with tablets too.