Getting Started

This guide will take you through required steps to send your first push notification via the Urban Airship dashboard. At the end of this walkthrough you will have successfully:

  • Set up your Urban Airship account
  • Integrated the Urban Airship SDK
  • Provisioned your app or website for push notifications
  • Sent your first test notification

While anyone should be able to follow these instructions and send a push notification, this is a technical process and should be completed by a developer with access to the proper mobile development tools and credentials for developer programs.

Register and Log In

If you already have a account, log in now and skip to Add Your Project. If you don’t already have an account, you will first need to choose a pricing plan. You may get started with the free Starter plan, or sign up for a more feature-rich paid plan.

  1. Choose a pricing plan.

    • Click the Getting Started button for either Starter or Basic, and continue the steps below.
    • If you prefer Essential or Comprehensive, click the Schedule Demo button, and an Urban Airship Account Manager will be in touch with you shortly.
  2. For Starter or Basic packages, enter your information and click the Complete registration button.

  3. Check your inbox for an account activation email, and click the activation link.

  4. Enter a password to complete your account setup.

  5. Click either the Mobile App or Web Notify option.

Add Your Project

When you create a project in the Urban Airship dashboard, you are creating an application record for your iOS or Android app. For Web Notify, your project is your website. Your Urban Airship app record is what we use to generate the required keys you’ll need to talk to different push notification services and keep track of your audience, messaging campaigns, analytics, and so forth.

If you just registered and clicked the Mobile App option, you are ready to add your first project.

If you already had an account, click the Create Project button in the upper right corner of the dashboard, then continue with the steps below.

Add Your First Project

Anyone can set up an Urban Airship project at this stage, but the next several steps (uploading the push certificate, installing the SDK) will need to be completed by a developer.

  1. Enter your project’s name, set its icon and environment, and select its platforms.
    • Name: Enter a descriptive name for your project. You have the option to change it later.
    • Icon: Optionally upload your icon. This does not have to be the same icon you submit to app marketplaces, but that is the typical practice.
    • Platforms: Click to select all the development platforms for which you plan to integrate Urban Airship. In subsequent steps, you will be asked to provide credentials, e.g., APNs certificate, FCM API key, in order to authenticate with the relevant push providers.
    • Environment: If this is your first time configuring a project for Urban Airship, you should likely choose Development for sending test messages.
  2. Click the Create Project button, or cancel to discard. After saving, the next screen will display the Quickstart Guide.
Some of our customers have only one project, and some have hundreds. If you work in a large organization, keep in mind that other people in your company may need to search for this project, so give it as descriptive a name as possible and adopt a naming convention. Examples: Anytown News iOS - Development, McDowell’s Chicago Android - Production.

Ultimately, you will want to have both a development build for testing and a production build for public release. For more information about development vs. production apps in Urban Airship, see:

Set Up Your First Project

You’re now ready to create your first project by following our Quickstart Guide. Follow the step-by-step instructions on each platform tab.

You’ll download the SDK, install it in your app or website, upload your certificate, and send a test push for the platform(s) of your choice.

Add Your Channel ID to Test Devices

Before you can send a test notification to a mobile device, you need to determine its Channel ID and then add it to your Test Devices list. You have two options:

Option 1: Speak with one of your developers about getting your device added to the Test Devices list.
Option 2: Follow the documentation in Audience: How to Find Your Device Identifier: Mobile Devices then, add your device to the Test Devices list.

Option 2 includes the instructions for using Charles Proxy to expose your Channel ID. Even if you’re comfortable with using Charles Proxy, you may want to speak with your developer before you attempt to retrieve your Channel ID yourself. Your app may have been designed with a hidden feature that allows you to quickly retrieve your ID, saving you the difficulty of working with Charles Proxy.

Once your Channel ID has been added to Test Devices, you are ready to proceed to the next section.

Send Your First Notification

This section will walk you through sending your first push notification via our Message composer. The notification will be a simple, text-based notification sent to Test Devices.

Test Devices include mobile devices only. In the following steps, caveats are noted for web browsers in the case that you choose to send to an audience other than Test Devices.

  1. Choose your project from the Urban Airship dashboard, then click the Create button, and select the Message composer.
    Your steps are tracked in the progress header. Completed steps display a green checkmark icon, showing you are ready to proceed. A red (!) icon appears if you need to fix anything. Click a step name to move ahead or to go back and edit.
    Your message’s selected conditions are displayed in a Summary on the right side of the window. The Help tab displays information relevant to the current step. Hover over composer sections to expose a (?) icon. Click the icon, and the Help tab will update with that topic.

  2. Select the radio button for Test Devices, then click Content in the progress header.

    When composing a message, you have the option to modify which Platforms are included in your audience. Since you have already restricted the message audience to test devices only, there is no need to make a change to the selected platforms.

  3. Click the pane for Push Notification, then click the Continue button that appears.

    If you have included the Web Browser or Windows platforms, Push Notification will be the only message type displayed.

  4. Enter your message in the text field and you will see it in the previewer to the right. Then click Delivery in the progress header.
  5. Select the radio button for Send Now, then click Review & Send in the progress header.
  6. Review the information on the left side of the screen, and click through the images in the previewer. The platform and display type are dynamically updated above.
  7. Click the Send button at the bottom of the window.

If all has been configured correctly, you just sent your first push notification! Because the message was sent to Test Devices, you should see the push notification appear on your mobile device. If this is not the case, review adding your Channel ID to Test Devices and reattempt the tutorial.

Next Steps

Learn the Dashboard and Composers

Learn how to use and the composers:

Send More Notifications

Our Message Composer Tutorial walks you through all the features and options. See the Web Notify Tutorial if you are sending to web browsers only.

Try Other Ways to Send a Message

Try all the message tutorials, including:

Customize Your Messages and Audience

Learn Product and Feature Details