---
name: "Marketing: OneSignal"
description: Push notification, email, SMS, and in-app messaging platform for customer engagement at scale. Run it via run_marketing_tool (tool="onesignal").
version: 1
situations: push, onesignal
requires-secrets: ONESIGNAL_REST_API_KEY, ONESIGNAL_APP_ID
requires-packages:
---

# Marketing: OneSignal (Push)

Push notification, email, SMS, and in-app messaging platform for customer engagement at scale.

Call the `run_marketing_tool` tool with `tool: "onesignal"` and `args: [...]` — args is the same
`{resource} {action} [--flag value ...]` shape as the CLI itself. Output is JSON on stdout.

Example: `run_marketing_tool` with `tool="onesignal"`, `args=["--help"]`.

Use `--dry-run` on any command to preview the request without sending it. Full command reference (every resource/action/flag): [reference.md](reference.md).

Needs the secret(s) `ONESIGNAL_REST_API_KEY, ONESIGNAL_APP_ID` set in the vault (Secrets UI) — ask the operator to add them if
`run_marketing_tool` reports they're missing.