diff --git a/Notify_onesignal.md b/Notify_onesignal.md
new file mode 100644
index 0000000..fd7a821
--- /dev/null
+++ b/Notify_onesignal.md
@@ -0,0 +1,62 @@
+## OneSignal Notifications
+* **Source**: https://onesignal.com
+* **Icon Support**: Yes
+* **Message Format**: Text
+* **Message Limit**: 32768 Characters per Message
+
+1. Visit https://onesignal.com to create your account.
+2. To acquire your `{appid}` and `{apikey}` Clic on the **Keys and IDs**.
+
+### Syntax
+The syntax is as follows:
+* `onesignal://{app_id}@{apikey}/#{include_segment}`
+* `onesignal://{app_id}@{apikey}/#{include_segment1}/#{include_segment2}/#{include_segmentN}`
+* `onesignal://{app_id}@{apikey}/{player_id}/`
+* `onesignal://{app_id}@{apikey}/{player_id1}/{player_id2}/{player_idN}`
+* `onesignal://{app_id}@{apikey}/@{user_id}/`
+* `onesignal://{app_id}@{apikey}/@{user_id1}/@{user_id2}/@{user_idN}`
+* `onesignal://{app_id}@{apikey}/{email}/`
+* `onesignal://{app_id}@{apikey}/{email1}/{email2}/{emailN}`
+
+You can also mix/match the targets:
+* `onesignal://{app_id}@{apikey}/{email}/@{user_id}/#{include_segment}/{player_id}`
+
+If you defined a template with OneSignal, you can use it as well:
+* `onesignal://{template_id}:{app_id}@{apikey}/#{include_segment}`
+* `onesignal://{template_id}:{app_id}@{apikey}/#{include_segment1}/#{include_segment2}/#{include_segmentN}`
+* `onesignal://{template_id}:{app_id}@{apikey}/{player_id}/`
+* `onesignal://{template_id}:{app_id}@{apikey}/{player_id1}/{player_id2}/{player_idN}`
+* `onesignal://{template_id}:{app_id}@{apikey}/@{user_id}/`
+* `onesignal://{template_id}:{app_id}@{apikey}/@{user_id1}/@{user_id2}/@{user_idN}`
+* `onesignal://{template_id}:{app_id}@{apikey}/{email}/`
+* `onesignal://{template_id}:{app_id}@{apikey}/{email1}/{email2}/{emailN}`
+
+### Parameter Breakdown
+| Variable | Required | Description
+| ----------- | -------- | -----------
+| app_id | Yes | This is the Application ID associated with your OneSignal account.
+| apikey | Yes | This is the API Key associated with your OneSignal account.
+| template_id | No | The UUID Template ID you wish to use
+| player_id | No | A Player ID to notify
+| user_id | No | A User ID to notify.
**Note**: these must be prefixed with an `@` symbol or it will be interpreted as a Player ID
+| include_segment | No | An include segment.
**Note**: these must be prefixed with an `#` symbol or it will be interpreted as a Player ID
+| email | No | An email to notify.
+| subtitle | No | The subtitle of your push. Only appears on iOS devices.
+| language | No | The 2 character language code to push your message as. By default this is set to `en` if not specified.
+| image | No | to include the icon/image associated with the message. By default this is set to `yes`.
+
+#### Example
+Send a OneSignal notification to all devices associated with a project:
+```bash
+# Assume:
+# - our {app_id} is abc123
+# - our {apikey} is a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty
+# - our {player_id} is 3456-2345-a3ef
+apprise -vv -t "Test Message Title" -b "Test Message Body" \
+ onesignal://abc123@a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty/3456-2345-a3ef
+
+# Override the subtitle (Mac users only) by doing the following:
+# You must use URL encoded strings, below the spaces are swapped with %20
+apprise -vv -t "Test Message Title" -b "Test Message Body" \
+ onesignal://abc123@a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty/3456-2345-a3ef?subtitle=A%20Different%20Subtitle
+```