Apple Push Notification (APN) – Connection & Settings

Estimated reading time: 3 min
APN Banners Apple Push Notification (APN) - Connection & Settings

Apple Push Notifications allow developers to send timely updates and alerts to users’ devices through the Apple Push Notification service (APNs), enhancing user engagement and app functionality.

Integrating APNs into the Wiresk platform brings a significant advantage by allowing automated workflows to connect directly with customers or team members through Apple devices.

A connection to your APN app is needed so we can sync it with our platform.

This goes into the Topic field in Wiresk.
  • Still in Certificates, Identifiers & Profiles, create an Apple Push Notification service SSL (Sandbox & Production) certificate for your app.
  • Download the .cer file, install it into Keychain Access, and export it with its private key as a .p12.
  • Convert .p12 to .pem using OpenSSL (as described in the Wiresk doc).
Upload the .pem into Wiresk.
  • Apple has two APNs endpoints:
    • Sandbox (testing): https://api.sandbox.push.apple.com
    • Production (live): https://api.push.apple.com

Apple reference: APNs Provider API – Communicate with APNs

Pick the one matching your certificate and your device token environment.
  • In your iOS app, register for remote notifications and capture the device token in didRegisterForRemoteNotificationsWithDeviceToken.
  • This token changes depending on environment (sandbox vs production).

Apple reference: Registering for Remote Notifications

Use it in the Test Device Token field in Wiresk.

There are two ways to connect your app to Wiresk:

  • In “My apps” section, where you can manage your connections (select or create your group first to get access to this section, refer to the Group system ).
  • While building your Flow, you can easily establish a connection to your app directly within the Flow builder. This can be done during the setup of either a Trigger or a Method.

This guide explains how to set up a connection in “My apps” section, which is essentially the same process as creating one on-the-go.

  • On your Wiresk’s Dashboard, select your Group.
  • On the left panel, go to “My apps” and select create button
  • Search “Apple Push Notification (APN)” in the search field or scroll down the list of apps and choose the APN icon.
Animated image GIF, showing the step of how to create an app connection. First, select the group then select My Apps tab, and click on the "+ create" button.

Fill in the fields:

  • Name: Internal name for your connection
  • Apple Notification Server URL:
    • Sandbox: https://api.sandbox.push.apple.com
    • Production: https://api.push.apple.com:443
  • Topic (App bundle name): Your app’s Bundle ID (e.g., com.company.myapp).
  • Apple Push Notification Certificate (.pem file): Upload your converted .pem.
  • Test Device Token (optional): Paste your device’s APNs token for testing.
  • Save your connection, and voila! you are a ready to go.
Wiresk interface showing Apple Push Notification (APN) connection setup form with fields for Name, Apple Notification Server URL, Topic (App bundle name), certificate upload, and Test Device Token, plus Test and Create buttons.

Now that your app is linked to Wiresk, you’re ready to start building Flows.

Simple steps to create a Flow ↓
  • Select your Group, then on the Flow management screen click on “Create Flow”.
  • On the new screen, name the new Flow.
GIF animated screen of Wiresk, showing the way to create a new Flow.

Add a Trigger that will start your Flow

Flows can be executed by multiple Triggers, depending on the desired workflow. For example, you could use scheduled Triggers with different recurrence rules alongside a Webhook Trigger for immediate, event-driven runs of the Flow. If you choose to “Run Once“, the Flow will execute using only one Trigger and its sample data.
  • Click on the (+) button to open the Trigger settings side panel.
  • On the settings side panel, click on the “+ Add” button.
Screenshot of the Wiresk side panel titled “Trigger.” The panel shows a section labeled “All Triggers” with a blue “+ Add” button for inserting a new Trigger.
  • On the Trigger selection screen, search your app or select it from the list below the screen.
Screenshot of Wiresk Trigger setting screen. Red arrows shows that you can wether search your app in the search or or select it in the list below.
  • Select your preferred Trigger on the next screen and customize its settings.
As mentioned in “How to connect your app to Wiresk” above, during your Trigger settings, you can create a new connection to your apps at this stage.

Add a Method that will execute a task

The Method will perform a specific task on a particular app or service you’ve connected to Wiresk like get info or send emails.

You can add at least 1 or multiple Methods for complex Flows (a maximum of 255 Methods).
  • On the Flow builder, select the (+) plus button next the Trigger button.
  • Search or scroll down to select the app that will perform a task.
  • Configure the Methods settings, refer to it documentation in our Help Center.
Screenshot of Wiresk Flow Builder with a Flow named “Flow Example.” The canvas shows a Gmail Trigger on the left connected to an empty step placeholder marked with a plus icon in the center. On the right, the panel lists available apps and tools. A search bar is displayed at the top of the panel for filtering apps. Red arrows highlight the empty step placeholder, the search bar, and items in the app list.

Add Wiresk Tools to your Flow

If you want to build a complex Flow, Wiresk offers a selection of tools at your disposal. Refer to Wiresk’s Tools

To add Tools in your Flow, Follow the same step as adding the Methods.

  • On the Flow builder screen, click on the plus button (+) then just click on the “Tool” tab and select the Tool that you want to add.
Screenshot of Wiresk Flow Builder showing a Gmail Trigger connected to an empty Method placeholder. A red arrow points to the empty step circle with a plus sign where the next action will be added. On the right side, the “Tool” tab is selected in the panel. Another red arrow highlights the “Tool” tab label at the top. A search bar is shown above a list of available tools.

You can refer to “How to Create a Flow” tutorial for more detailed instructions, including step-by-step guidance on mapping and configuration.
apple Apple Push Notification (APN) - Connection & Settings

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*Push Notification
Connection*Select your connection or create one.

MAP FIELDS

Device Token*

Identifies which device gets the push.

APS

Alert

Title*: Headline in the notification.

Subtile: Plain text subtitle shown under the title in the push notification.

Body: The main message text.

Body Localyze Key:

  • A key string that maps to a localized message in your app’s Localizable.strings.
  • Used instead of sending a raw “body” string.
  • In the app’s localization file, GAME_REQUEST_MESSAGE = "Bob wants to play poker";.

Body Localyze Arguments:

  • An array of arguments inserted into the localized string (placeholders %@, %d, etc.).
  • Localizable string: "GAME_INVITE_MESSAGE" = "%@ wants to play poker";
  • Display: “Bob wants to play poker”

Title Localyze Key:

  • A localization key for the notification title.
  • Strings file: "GAME_REQUEST_TITLE" = "Game Request";

Title Localyze Arguments:

  • Arguments to insert into the localized title string.
  • Localizable string: "NEW_SCORE_TITLE" = "%@ scored a new high score!";
  • Display: “Alice scored a new high score!”

Subtitle Localyze Key:

  • A localization key for the subtitle.
  • Strings file: "INVITE_SUBTITLE" = "Poker Night";

Subtitle Localyze Arguments:

  • Arguments for the localized subtitle string.
  • Localizable string: "INVITE_SUBTITLE_ARG" = "Game scheduled for %@";
  • Display: “Game scheduled for Friday”

Sound

Sound Name: e.g. default or custom sound file.

Critical: the notification play a critical alert sound, bypassing the device’s mute switch and Do Not Disturb settings.

set 1. Requires entitlement in your app.

Sound Volume: Controls the playback volume of the sound, from 0.0 (silent) to 1.0 (full volume).

Content Available

Enables background updates.

Mutable Content

Allows Notification Service Extensions.

Badge

Sets app icon badge number.

Thread ID

Groups notifications.

Category

Defines the notification’s type, used with actionable notifications.

Target Content ID

Directs notification to a specific content section in your app.

Interruption Level

Refer to UNNotificationInterruptionLevel

possible values:

  • Passive: Delivers quietly. No sound, no vibration, and does not light up the screen. Appears only in Notification Center.
  • Active: Default level. Standard alert: plays sound/vibration (if set), appears on lock screen and in Notification Center.
  • Time-sensitive: Overrides system focus modes like Do Not Disturb. Still respects “Notification Summary.” Should only be used for critical time-sensitive events (e.g. delivery, health alerts).
  • Critical: Requires special entitlement from Apple. Always breaks through system settings, plays a critical alert sound, and bypasses mute/silent mode. Intended for emergencies (e.g. safety, severe weather, medical alerts).
Important 01 Apple Push Notification (APN) - Connection & Settings