OneSignal

How to connect

Same URL, five paste targets. Ready surface · Auth required. Not a safe-to-install badge. Handshake this URL

• create_alias_by_subscription

  Create or update identity aliases for the user who owns a given subscription. The `onesignal_id` alias is read-only and must not be included.

• create_custom_events

  Record custom events for OneSignal users, such as purchases, content views, or milestones. Use these to enter users into Journeys or trigger Wait Until nodes. Each event must set at least one of `external_id` or `onesignal_id`.

• create_or_update_alias

  Create or update identity aliases for a user identified by alias. The `onesignal_id` alias is read-only and must not be included.

• create_segment

  Create a new audience segment with filter conditions. Maximum 200 filter entries.

• create_subscription

  Create a new subscription and attach it to a user. Set `type` to the channel ("Email", "SMS", "iOSPush", "AndroidPush", etc.) and `token` to the email address, E.164 phone number, or push token.

• create_template

  Create a new notification template for a OneSignal app.

• create_user

  Create a new user in a OneSignal app. Provide an `identity` (e.g. {"external_id": "user-123"}) so the user can be referenced later by alias. Optionally attach `properties` (tags, language, country) and `subscriptions` (email, SMS, or push channels). The `identity` field is required to prevent orphaned users.

• export_audience_activity_csv

  Export audience activity for a notification to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running.

• export_subscriptions_csv

  Export all subscriptions for a OneSignal app to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previous export is still running.

• get_custom_events

  List the custom event definitions indexed for a OneSignal app, including each event's properties, sources, most recent occurrence, usage locations (segment/journey), storage and total counts, and retention duration. Requires OAuth authentication.

• get_segment

  Retrieve a single audience segment by ID. By default, includes full segment metadata and filters (`payload` object with `id`, `name`, `created_at`, `source`, and `filters`). Set `include_segment_detail` to `false` to return only the subscriber count. Note: the API returns 400 for user-based segments (those using custom_event or message_event filters).

• get_template

  Retrieve a single notification template by ID.

• get_user_identity

  Retrieve all identity aliases associated with a user. Identify the user by `alias_label` (typically "external_id") and `alias_id`.

• get_user_identity_by_subscription

  Retrieve the identity aliases for the user who owns a given subscription.

• list_apps

  List OneSignal apps accessible to the authenticated user. Returns app names, IDs, and organization info. Supports pagination via limit and offset parameters.

• list_messages

  List push notifications for a OneSignal app. Use `limit` (default 50, max ~250) and `offset` for pagination. Avoid large offsets — this endpoint has known performance degradation at high page numbers.

• list_segments

  List audience segments for a OneSignal app. Maximum 300 segments per page.

• list_templates

  List notification templates for a OneSignal app. Maximum 50 per page.

• onesignal_config

  Return the current OneSignal MCP server configuration and connected app details.

• onesignal_health

  Check the health status of the OneSignal MCP server.

• onesignal_reference_overview

  Return an overview of the OneSignal REST API reference, including available endpoints and rate limits.

• send_message

  Send a push notification, email, or SMS via the OneSignal API. TIER 3 — HIGH IMPACT: confirmation is required before sending. Rate limited to 10 requests per minute. The `filters` array is limited to 200 entries; max 20,000 users per call. For push: set `contents`. For email: set `email_subject` + `email_body` (or use `template_id`). For SMS: set `contents` + `target_channel = "sms"`.

• start_live_activity

  Start an iOS Live Activity and deliver it to a specific device subscription.

• transfer_subscription

  Transfer a subscription to a different user within the same app. Cross-app transfers are not supported. Rate limited to 1 request per second per subscription.

• unsubscribe_email

  Unsubscribe an email address using the token from an email unsubscribe link. This endpoint uses token-based auth (no REST API key required).

• update_live_activity

  Update or end an active iOS Live Activity.

• update_segment

  Update an existing audience segment's name and/or filter conditions. `name` is always required even if not changing it (max 128 characters). When `filters` is provided it replaces all existing filters; omit to keep existing filters intact. Maximum 200 filter entries.

• update_subscription

  Update an existing subscription (token, enabled status, or test type).

• update_subscription_by_token

  Update a subscription identified by its channel type and token. Provide `subscription_type` and `token` to identify the subscription, then pass the fields to update in `subscription`.

• update_template

  Update an existing notification template. The `name` field is required even if you are not changing it.

• update_user

  Update an existing user identified by alias. Use `properties` to set tags, language, or country. Use `deltas` to increment session counts or append purchase records (these add to existing values rather than overwriting). Returns 202 — the update is processed asynchronously.

• view_message

  Retrieve a single notification by ID.

• view_outcomes

  Retrieve outcome statistics for a OneSignal app (e.g. click counts, session duration). Note: data retention is approximately 30 days.

• view_user

  Retrieve a user and their properties by alias. Use `alias_label` "external_id" with the user's external ID, or another alias label you have configured.

Tool source: tools/list (live) · last probed 2026-10-17

Related servers