Message delivery

Learn how to set up delivery in the Message composer.


In the Delivery step, first set up the timing. You can send immediately, schedule the delivery, set recurring delivery, or send at the user’s optimal time.

Send Now

Send the message immediately after review.


Choose an exact time of day to send the message.

  1. Enter a date in YYYY-MM-DD format and select the time and time zone.

  2. (Optional) Select Delivery By Time Zone to deliver messages at the specified time in your audience’s time zones. For example, a push notification scheduled for 9 a.m. will arrive for people on the east coast at 9 a.m. Eastern Time, in the midwest an hour later at 9 a.m. Central Time, then on the west coast two hours after that, at 9 a.m. Pacific Time.


    Messages are only delivered by time zone to channels that have a time zone set.

    App and Web channels have their time zone set automatically by the SDK.

    Email, SMS, and Open channels will only have a time zone if set through the channel registration API. To do so, enter a value for the "timezone" key in the request body. See:


    • A message delivered by time zone includes a Delivery by Time Zone section in its message report. See: View Message Detail.
    • The API equivalent of Delivery By Time Zone is Push to Local Time.


Send the message periodically at specified intervals. You may want to send recurring messages for things like payment reminders. You can pause, resume, and cancel recurring messages in Messages OverviewA view of all your project’s messages, with options for editing their settings, content, status, and more..


Segmentation data is evaluated at send time. For example, if your recurring message targets an audience list whose members change over time, each recurring message is sent to the current version of the list when the message is sent.


Recurring messages that include multi-language localized content cannot be edited.

  1. Specify the delivery interval by number of hours/days/weeks/months/years. For weeks, also specify which days of the week to send the message.

  2. Set the initial date. This is the first day Airship will send your message.

  3. Set the initial time. This is the time of day Airship will send each message.

  4. (Optional) Specify when to stop sending the message.

    1. Enable End date.
    2. Enter a date.
    3. Set the time and time zone.
  5. (Optional) Specify dates or days of the week when the message should not be sent. If you select the hours interval, you can also specify which hours of the day should be excluded. If you select the weeks interval, you can only specify which dates should be excluded.

    If the scheduled send falls during an excluded period, Airship waits to send the message until the next available valid send time. For example, if you scheduled delivery weekly on Thursdays but added the date for Thanksgiving Day as an exclusion, the next send would be the Thursday after Thanksgiving Day.

    1. Enable Do not send.
    2. Click Add date exclusion, enter a date, and repeat for additional dates.
    3. Click Add day exclusion and select days.
    4. Click Add time exclusion and set start and end times.


Send the message on a specific date and at each user’s Optimal Send TimeAn algorithm that determines the best hour for optimal engagement activity — when each individual member of your audience is most likely to receive and act on your message. iOS, Android, and Amazon platforms only.. iOS, Android, and Amazon only.

Enter a date in YYYY-MM-DD format.

Airship recommends scheduling your message at least three days in advance due to the combination of time zones and optimal times. You can reduce the lead time if your audience is more localized, e.g., only in the United States or in a certain European region.


Set or verify the Message PurposeA dashboard setting that designates a message as commercial or transactional.. This option only appears if Message Purpose is enabled for the project.

When Message Purpose is enabled and email and at least one other channel are selected for a message, Purpose is disabled in the Delivery step. Instead, set the purpose in the email’s Sender Information:

  1. Go to the composer’s Content step.
  2. Select the Email tab.
  3. Click Edit for Sender Information.
  4. Enable Transactional or leave disabled if the message contains commercial content only.

The commercial/transactional designation set in the email Sender Information will apply to all channels selected for the message.


After configuring the timing, set up delivery options.

External data feeds

If your message includes External Data FeedsA connection to an external API. When you send a message, Airship uses a response from that API to personalize messages., you must configure each feed listed in External data feed options.

  • Failure behavior — Determine how your message is handled if the feed fails. Select Abort sending the message or Send message without this data.

  • Default value for [var] — This displays the default value for each send time variable in the feed URL. You can change the value to override the default for this message only.

Ban list

If your project has a Ban ListAn externally maintained record of users that should not be included in Airship message audiences. Before sending a message, Airship validates the audience members with the Ban List. Any matching recipients are dropped from the audience before sending the message. enabled and its request URL includes send time variables, you can override their default values for this message only. Each one is listed under the heading Default value for <variable>. Enter a new value for any variable.