OneSignal

Let your agents send push notifications, emails and SMS through OneSignal to segments or to specific users, follow and cancel messages, and read your segments, templates and users (and update user tags).

Connection

Authentication: API key (App API key).

OneSignal dashboard → select your app → Settings (gear icon, bottom-left of the sidebar) → Keys & IDs → Add Key. Name it, leave the IP allowlist empty (otherwise calls from Atako are refused), click Create and copy the value right away (it starts with os_v2_app_ and is shown only once). A key works for one app: the App ID shown on the same page is required by every action — put it in the agent’s instructions.See OneSignal’s documentation.

Read actions (8)

Action	Description
`get_app`	Get one app: name, organization_id, subscription counts (players, messageable_players), enabled channels and push configuration. Push credentials (keys, certificates, passwords) are removed from the response. view: “config” skips the subscription counts (faster).
`get_message`	Get one message (push, email or SMS): content, targeting, schedule, status (canceled, completed_at) and delivery statistics (successful, failed, errored, converted, received, remaining, platform_delivery_stats per channel).
`get_template`	Get one message template: its content, target channel and timestamps.
`get_user`	Get a user by alias: properties (tags, language, timezone_id, country, first/last active), identity (all aliases) and subscriptions (push, email, SMS). alias_label: “external_id” (your own user id — the usual choice), “onesignal_id” or a custom alias label; alias_id: its value.
`list_apps`	List the apps of the OneSignal organization (id = App ID, name, subscription counts). Requires an Organization API key: with an App API key OneSignal answers 403 — the App ID is then on Settings → Keys & IDs. Push credentials (keys, certificates) are removed from the response.
`list_messages`	List the app’s messages, newest first (queued_at), with their content, targeting, schedule and delivery counts (successful, failed, errored, converted, remaining). limit: max 50 (default 50); offset: integer; kind: 0 = created in the dashboard, 1 = via the API, 3 = automated; template_id: only messages sent from this template; time_offset: ISO 8601 date-time or the token returned by the previous page.
`list_segments`	List the app’s segments (id, name, created_at, is_active), oldest first. The name is what create_message takes in included_segments. limit: max 300 (default 300); offset: integer.
`list_templates`	List the app’s message templates (id, name, created_at, updated_at). channel: “push” \| “email” \| “sms” to filter; limit: max 50 (default 50); offset: integer.

Write actions (3)

Action	Description
`cancel_message`	Cancel a scheduled message, or stop one still being sent. Args: app_id (UUID string), message_id (UUID string, from create_message or list_messages). OneSignal answers 400 when the message was already sent to everyone.
`create_message`	Send (or schedule) a push notification, an email or an SMS. Args: app_id (UUID string); target_channel (“push” \| “email” \| “sms”); exactly ONE targeting method: included_segments (array of segment name strings, e.g. [“Active Subscriptions”], see list_segments; optional excluded_segments, array of strings) OR include_aliases (object mapping an alias label to an array of strings, e.g. { “external_id”: [“user-42”] } — also “onesignal_id” or a custom alias label; max 20,000 ids) OR include_subscription_ids (array of subscription id strings) OR include_phone_numbers (array of E.164 strings, sms only). Content — push and sms: contents (object language code → string, “en” required, e.g. { “en”: “Hello”, “fr”: “Bonjour” }); push only: headings (same shape, title; must use the same languages as contents), subtitle (same shape, iOS), url (https string), data (object, custom data passed to the app). Email: email_subject (string) and email_body (HTML string), optional email_from_name, email_from_address, email_reply_to_address, email_preheader (strings). SMS: optional sms_from (string, sender phone number or messaging service id). Alternatively template_id (UUID string, see list_templates) replaces contents / email_subject / email_body, with custom_data (object) for its variables. Optional for all: send_after (ISO 8601 date-time string, schedules the message), name (string, internal), idempotency_key (UUID string, prevents duplicate sends on retry). Returns the message id (empty id = not sent) and invalid identifiers in errors.
`update_user_tags`	Add or update tags on a user (used for segmentation and personalization). Args: app_id (UUID string); alias_label (string: “external_id”, “onesignal_id” or a custom alias label); alias_id (string, its value); tags (flat object of string keys to string values, e.g. { “plan”: “pro”, “city”: “Lyon” } — no arrays nor nested objects). Tags not listed are left unchanged; your OneSignal plan caps the number of tags per user.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (8)

Write actions (3)

Permissions

​Connection

​Read actions (8)

​Write actions (3)

​Permissions

Connection

Read actions (8)

Write actions (3)

Permissions