The Settings section of the dashboard is where you control your app’s configuration, integrations, permissions, and more.

Choose your app from the Urban Airship dashboard, click the gear icon (Settings) dropdown menu, and make your selection. Each section’s purpose and options are detailed below.

Quickstart Guide

The Quickstart Guide walks you through the technical steps you need to perform in order to send your first push notification.

Documentation for implementing the Urban Airship SDK, connecting to push notification services, e.g., APNs and GCM, and configuring your project for push notifications is provided from within the guide.

App Details

App Details is where you can change your app’s name, set its icon, and select its mobile platforms.

  1. Enter your app’s display name.

  2. Optionally choose or change the app icon.

  3. Click to select or remove the platforms that will use Urban Airship. Selected platforms are highlighted blue.

  4. Click the Save button, or click cancel to discard your changes. Clicking cancel will return you to the app dashboard.

Delete your app by clicking delete this app in the lower right corner.

Team Access

Team Access is where you can view and manage app-related responsibilities.

Accounts Registration

When you register on, two linked accounts are created:

  1. Company Account

    • Where apps are created and contained.
    • Controlled by a single User Account.

  2. User Account

    • The Owner of the Company Account.

Access Overview

  • Only the Owner of a Company Account can create apps for that company.

  • Access is set for each app individually.

    • User Accounts that have an assigned role for a particular app are members of that app’s Team.
    • When an Owner creates an app, the Owner is automatically its first Team member.
    • A User Account can only be an Owner of one company but may be a Team member of multiple apps.
  • App Team members will only see the app functions that apply to their role(s). For example:

    If you’re assigned to Composers Only, you will see in the app dashboard:

    • The Create New button
    • The Messages menu

    If you’re assigned to Reports and Composers, you will see in the app dashboard:

    If you’re assigned to Reports Only, you will see in the app dashboard:

    • The Messages menu, with options limited to report-related content
    • The Reports menu

Users cannot create apps in Company Accounts they do not own. If you need a new app to be created in a Company Account that you are not the Owner of, the Owner of that Company must first create the app, then invite you to the new app’s Team.

Role Responsibilities

Tasks by Individual App Owner Administrator Full Access Reports Only Composers Only Reports & Composers Reports, Composers, Segments
Create an app X
Delete an app X
View App Key, Secret, and Master Secret X X X
Create Message Personalization Templates X X X
Modify App Details X X X
Create and modify an IP Whitelist X
Send a Team Access invitation to a new individual X X
Change an existing Team Member’s app role X X
Remove a Team Member’s access to an app X X
Modify Team Management Security options X
Compose Messages, Automated Messages, and A/B Tests X X X X X X
View, print, and export Reports X X X X X X
View, create, and modify Segments X X X X

Sending Team Access Invitations

  1. Click in the field Give Access to this App, and it will expand.

  2. Enter the email address or username of the user you want to invite.

    If the user has an existing Urban Airship account, enter the user’s Urban Airship username. Otherwise, enter the user’s email address. In either case, the user will receive an email with an invitation to accept the new access. See Accepting Team Access Invitations.

    Usernames are case-sensitive. Always use the username, if available. If you enter an email address for an existing Urban Airship user and that user’s account is associated with a different email address than the one you are inviting, he or she may attempt to create a new account.

  3. Select the Access Level from the dropdown menu. See Role Responsibilities for detail.

    If you entered a username or email address matching an existing Urban Airship user, when you click the Access Level menu, a banner appears below the menu, alerting you that the user “already has a role on this app!”

  4. Choose whether to send the invitation from Urban Airship or [Your] email address.

    My email address
    This is the best option, as the invitation will appear as being sent directly from you, and you will receive any bounce notifications in the case the email address is invalid. The invitation is also less likely to be caught in the recipient’s spam filter.

    Send from Urban Airship
    Some companies’ email servers enforce a rule requiring domain name and email sender fields to be the same. If this is true for your company, choose this option to ensure that your email goes through. However, you may also want to ask the recipient to look for this email and also check any spam filter for it.

  5. Optionally Add a personal note.

  6. Optionally check the box to Send a copy to yourself.

  7. Click the Give Access button, or click cancel to discard.

The new user will be listed in the Team Access list by username if an account already exists, or by email address if an account still needs to be created. Users with pending invitations have (pending) noted next to the username or email address.

When a user either accepts an invitation or creates an Urban Airship account, the (pending) designation no longer appears next to the username in the Team Access list.

If a user with an existing Urban Airship account declines an invitation, the user will be removed from the app’s Team Access list.

A user without an Urban Airship account will remain on the Team Access list as (pending) until access is accepted, or until manually removed.

Accepting Team Access Invitations

Users who do not yet have an Urban Airship account will receive email with subject Activate your Urban Airship account and a request to follow a link to confirm the email address and activate the account. Saving the password activates the account.

All users will receive an email to accept the app access at If already logged in, this is accessible by clicking your username in the upper right corner, then selecting Team Management from the dropdown menu.

See Managing Your Account: Team Management for information about accepting invitations.

Changing App Roles

  1. Click edit next to the user’s current Access Level.

  2. Select a new role from the dropdown menu.

  3. Click the Save button, or cancel to discard the change.

Removing Access

Using the same steps as Changing App Roles, select Remove Access from the dropdown menu.


Services is where you add, manage, and remove the third-party messaging platforms you have configured for your app, e.g., APNS.

For information about configuring new services, see the Getting Started documentation.

To manage or remove existing services, click the Edit button at the end of its row. Configuration fields vary per service. If you have APNS configured, its expiration date will display, and you have the option to upload a new certificate.

Click the Save button, or cancel to discard.

To remove the service from your app, click remove this service.

Additional Services

If your account has been enabled for Apple News Push Notifications, configure it here. See the Apple News composer for usage information.

  1. Click the Configure button. The button is labeled Edit if already configured.

  2. Enter values for each field, and check the box for each of the Supported Countries you have configured in your Apple News publisher channel settings.

    • Channel Name: Your Apple News channel name. This is used for preview purposes in the composer.
    • Channel ID: Your Apple News channel ID.
    • API Key: Your Apple News API key.
    • API Secret: Your Apple News API secret.

  3. Click the Save button, or cancel to discard.

    To remove the service from your app, click remove this service.

  1. Your Apple News channel ID has no relation to an Urban Airship Channel ID.

  2. We validate the country selection when the Send Now or Send When Live button is clicked as the final step in composing an Apple News message. If a country selected here is not configured in your Apple News publisher channel settings, you will see an error in the composer when attempting to send to that country.


Configuration is where you control the features and settings related to composing and sending messages. Four tabs organize the settings for Deep Links, Notification Buttons, In-App Messages, and Automation Limits. See the composers for reference:

Composer Configuration

Each feature is listed with a description and its minimum SDK version. Toggle to enable/disable.

The On/Off feature controls only apply to functionality within the message composers. They do not enable or disable functionality at the API level.

  • Message Center: Deliver rich content to a message center in your app. SDK 2.0+

  • Delivery by Time Zone: Schedule a message to go out at the same time in different time zones. SDK 3.1+

  • Landing Page, Deep Link, URL, and Add Tags: UA Actions Framework. SDK 4.0+

  • Remove Tags: Remove a tag when a user interacts with a push notification or button. SDK 4.0+

  • Notification Buttons: Interactive notifications for your app, including our 30+ out-of-the-box buttons. SDK 5.0+

  • In-App Messages: Send a message that appears inside your app. SDK 6.0+

  • Custom Keys: Pass key/value pairs of custom data through the push to your app. All SDKs.

  • Broadcast Push: Option to send to all app users. All SDKs.

Some newer Notification Buttons require a later SDK. See Built-In Interactive Notification Types for the full list and SDK requirements.


A description of each Predictive type is below. Toggle to enable.

  • Churn: Analyze your app’s audience to identify user devices that exhibit behaviors indicating they are likely to become inactive. You must have at least one week of churn analysis before you can target churn risk groups. See the Predictive Churn topic guide for usage information.

The Deep Link Action directs the user to a specific resource, either within your app or on the web. A Deep Link must be in the format of a URL. Deep Link templates are URLs with placeholders in the path. Specify the path when composing your message — each segment appears as an individual text field. See the Actions topic guide for more about Deep Links.

  1. Click the + Deep Link button.

  2. Enter a Name for the Deep Link, and a URL in the URL Template field.

    Deep Link URLs have a maximum length of 255 characters.

    Template segments must be contained in curly braces: { }. The Deep Link Preview appears to the right of the entry fields. If the URL is entered in template format, each segment’s field is shown as it will appear when composing a message.

    The URL is validated as you type. A warning banner will appear if the URL format is incorrect, or if a single brace is used, rather than an enclosing pair.

  3. Click the Save button, or cancel to discard.

Fields for template segments do not support slashes (“/”) .

If you want to send a Deep Link for, you must first edit the template to include both the category field (e.g., productivity) and the specific product field (e.g., calculator).

An alternative configuration would be to edit the URL template to read{widget}. You can create additional Deep Links for separate categories as necessary. For example, if you need a finance category, you can create a new deep link with URL template{widget}. This would save users from having to remember the full list of categories and their spellings.

From the Deep Link tab, edit or delete an existing Deep Link by clicking the pencil and trash can icons, respectively. Editing Deep Links requires Administrator, Owner, or Full Access role. See: Team Access.

Notification Buttons

Notification Buttons prompt a user to take specific actions within or outside of the app. Optionally include buttons when composing a message. There are 30+ predefined Notification buttons to choose from, depending on your SDK version. Create custom buttons here.

Using Notification butttons in your message automatically creates Custom Events, where one event is assigned to each button. When viewing the associated Message Reports or the Event Tracking report, you will see a custom event listing for any button that has been pressed.

  1. Click the New Notification Buttons button.

  2. Enter a Name and Description so you can easily find it in the full list of buttons.

  3. Enter the Category name, which is passed to the mobile device to identify which notification buttons to display with a message.

    Uncheck the Enabled box if you do not yet want these buttons to appear in the list of Interactive Notifications buttons when composing a message.

  4. Specify the button’s label and actions.

    • Button Label: Identifies button label for display purposes in the message composer. Should match the label defined in the app. Does NOT change button labels in app.
    • ID: Associates actions with the correct button label when passed by message.
    • Foreground or Background: Controls which actions are available in the Message Composer. Must match button ID defined in the app.
    • Destructive: Indicates if button action causes the removal of data, features, etc. Appears red on iOS. Must match capability defined in the app. Check the box to enable.

  5. Optionally fill out the same information for a Secondary Button.

  6. Click the Save button, or cancel to discard.

From the Notification Buttons tab, edit or delete existing buttons by clicking the pencil and trash can icons, respectively.

In-App Messages

In-App Messages are banner notifications that appear inside of your app. Configure their appearance.

  1. Enter the hex values for the Primary and Secondary Colors. Primary is the message backgrouns. Secondary is the message text.

  2. Choose whether the In-App Message will appear at the Top or Bottom of the screen.

  3. Set the Duration of time that the In-App message displays on the screen. Default is 15 seconds, or select Specify and enter a value for the number of Seconds or Minutes.

  4. Click the Save button.

Automation Limits

Automation Limits control over-notification to users who repeatedly meet Automation Composer criteria, capping automated messages per device per given time interval, e.g., a maximum of 4 messages every 10 hours. Add, edit, and delete Automation Limits here.

  1. Click the + Add Limit button.

  2. Enter the maximum number of messages to be sent within the time period, then define the time period with a number of Hours or Days, no more than 48 hours or 90 Days.

    To add another, click the +Add Limit button and continue with your specifications. Two limits are the maximum.

  3. Click the Save button.

Edit the limits at any time. Delete a limit by clicking the X at the end of its row.

Automation Limits occur at the app level. You can also create a Rule Limit for a specific message. For example, if you create an Automated Message with a trigger that is likely to occur frequently, a Rule Limit would prevent the repeated delivery of the same message to the user. See Automation Set Up options.

Indicator Locations

Automation Limits indicators are in multiple locations.

Automation Composer: The last option in Automation Composer Set Up.

Messages Overview: The bottom right corner of the Messages » Messages Overview » Automated tab.

Message Report: The top right corner of an Automated message’s Message Report.

APIs and Integrations

Your API & Integrations information, options, and settings are organized in three tabs: Urban Airship API, Integration Options, and Gimbal.

Urban Airship API

View your app’s App Key, App Secret, App Master Secret, and Configuration Details. For more information, see App Keys & Secrets: Security.

Integration Options

Configure the Mobile Data Bridge for Named Users and Tag Groups. See the Mobile Data Bridge Primer for requirements and usage information.

Named Users

By default, Named User association can only occur server-side, via the API. The setting in this menu overrides that preference, enabling client-side Named User association. Toggle to enable.

Before enabling client-side association, consider your use case. By restricting association to server-side calls only, you have the added security of requiring your master secret to be verified after each call. While this creates a more secure call to association, you also lose the convenience of having your application automatically associate named users on login. Most apps will not require this additional security, but if your app deals with extremely sensitive data, you may want to consider leaving this disabled and doing named user association exclusively through the API.

Tag Groups

Tag Groups are configurable namespaces for organizing tags. Primary Device Tags is a predefined Tag Group, and you may create up to five custom Tag Groups. See Tag Groups Walkthrough for usage information.

Existing tags associated with your mobile audience are listed under Primary Device Tags. In most cases this means all the tags that are currently being set via the Urban Airship SDK based on users’ interaction with the app. For example, if you send a push that sets a tag on a user after they tap it, then that tag is added to the Primary Device Tags group.

Create a Tag Group

Tag Groups cannot be deleted, and the Group Key field and security setting cannot be edited. Please double check that the Group Key is correctly filled out and the security setting is appropriate.

  1. Click the + Tag Group button.

  2. Enter a Name, Description, and Group Key for the new tag group.

    This Name appears elsewhere in the UI, so choose something easily understandable that directly links back to the associated database, e.g., “Loyalty Database Tags.”

    The Description should supplement the title, giving additional information about the Tag Group, if necessary. Be descriptive enough that anyone in your company would understand its source and purpose.

    Group Key
    This permanent, unique ID is the text you will use when referring to your Tag Group in the API. While you can use any characters for the Group Key, it is highly recommended that you exclusively use lowercase ASCII characters. No spaces are allowed in a group key. Example: pos-database.

  3. Optionally enable high security for read-write operations, only allowing tags be read or changed by API calls authenticated with your master secret key. Check the box to Allow these tags to be set only from your server.

  4. Click the Save button, or Cancel to discard.

Urban Airship reserves Tag Groups prefixed with "ua_". Any Tag Groups you might create with that prefix will not function.

Without this Security setting enabled, tags can be read and written from an app using only the application secret. By enabling the high security setting, read-write operations must be validated with your master secret key, preventing attackers from using the app secret to set or read their own device tags. Whether or not your app will benefit from this added security depends on the use case. If preventing attackers from reading or setting their own device tags is absolutely critical, consider enabling this feature.

Edit a Tag Group

Your custom Tag Groups are listed below the Primary Device Tags box. Click the Edit button to make changes.

Only Name and Description are editable fields. You may also check/uncheck the box to Enable this Tag Group. Click the Save button, or Cancel to discard.


When sending an Automated message, you may choose to trigger sending the message based on Location. Location Triggers require integration with the Gimbal Platform. See Location Triggers for requirements and set up information.

If you have already configured Gimbal, you have two options.

  • Sync location data from Gimbal: Click the Sync Now button.

  • Delete your current Gimbal Server API key: Click remove this API Key. A warning displays with confirmation steps. Check the box for I would like to proceed and click the Yes, remove button, or click the Nevermind button to cancel.

Test Push

The Test Push form is a simple utility for testing push notifications without needing to format HTTP requests using a Command-line tool such as cURL. One tab is displayed per platform. Platforms are configured in Settings » Services.

The Test Push form supports sending test notifications to iOS, Android, Windows Phone 8 and Windows 8. Amazon is not supported, and no new delivery platforms will be added to this legacy utility in the future.

Select a tab, fill out the fields, then click the Send it! button. Fields per platform are listed below.


  • Channel ID or Device Token: Specify the device you are sending the test push to by entering a Channel ID or device token.

  • Badge: Enter a badge value to indicate an unread count. Alternatively, you may use the autobadge feature.

  • Alert: Enter the text to be displayed in the alert view.

  • Sound: Specify a custom sound for the alert. A Core Audio Format (CAF) file must be present in the application build in order to play the sound. If no custom sound is provided, the default sound will play.

  • Payload: Use JSON to specify the notification payload. It is not necessary to enter the JSON directly into this field; the field will automatically populate based on the values given in the fields above.


  • Channel ID or APID: Specify the device you are sending the test push to by entering a Channel ID or APID.

  • Alert: Enter the text to be displayed in the alert view.

  • Extra key: Pass an extra (custom) key to the app in the notification payload.

  • Extra value: Pass a value for the extra key.

Windows 8 / Windows Phone 8

  • APID: Specify the device you are sending the test push to by entering an APID.

  • Alert: Enter the text to be displayed in the alert view.