delete_user
Delete User
Permanently delete a user and all associated data by alias. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
Ask your agent in plain language. Each of these maps to a real tool on the server.
delete_user
Permanently delete a user and all associated data by alias. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
get_user
Retrieve a user's profile, properties, identity, and all subscriptions by alias (external_id or onesignal_id). Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
create_segment
Create a dynamic audience segment with filter rules. Segments automatically update as users match the criteria. Combine filters with AND/OR operators. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
create_app
Create a new OneSignal app under your organization. Requires an Organization API Key. Optionally configure platform-specific push settings.
cancel_notification
Cancel a scheduled or in-progress notification by its ID. Only notifications that have not yet been fully delivered can be cancelled. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
delete_template
Delete a message template. Templates used in active Journeys cannot be deleted. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
create_subscription
Add a new subscription (push device, email, or SMS) to an existing user. The user is identified by alias. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
view_notifications
Retrieve notification details and delivery analytics. Can list recent notifications with pagination or fetch a specific notification by ID with detailed outcome metrics. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
update_user
Update a user's properties such as tags, language, timezone, location, and country. Identify the user by alias label and alias ID. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
delete_segment
Delete a segment by its ID. System (read-only) segments cannot be deleted. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
transfer_subscription
Transfer a subscription from one user to another. Useful when a device changes ownership. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
delete_subscription
Remove a subscription (device/email/SMS) from a user permanently. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
create_user
Create a new user in OneSignal with optional identity, properties (tags, language, country), and subscriptions (push, email, SMS). Use update_user to change properties of an existing user. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
update_app
Update an existing OneSignal app's settings. Requires an Organization API Key.
create_template
Create a reusable message template for push notifications, emails, or SMS. Templates simplify sending consistent messages across campaigns. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
get_app
Retrieve details for a specific OneSignal app by ID. Requires an Organization API Key.
update_subscription
Update an existing subscription's token or enabled status. Subscription types are immutable; recreate the subscription to change its type. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
list_segments
Retrieve all segments for the app with pagination support. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
get_template
Retrieve the full details of a specific template by its ID. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
send_notification
Send a push notification, email, or SMS/MMS message through OneSignal. Supports targeting by segments, user aliases, filters, subscription IDs, email addresses, or phone numbers. Can include rich content like images, action buttons, and custom data. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
export_data
Export user and subscription data as a CSV file. Returns a URL to download the gzip-compressed CSV. The file may take some time to generate and is available for 3 days. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
update_template
Update an existing template's name, content, or other properties. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
list_apps
Retrieve all OneSignal apps under your organization. Requires an Organization API Key.
list_templates
Retrieve all message templates with optional channel filtering and pagination. Provide appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
update_user_aliases
Add or update external_id or custom aliases for an existing user. Use appId from list_apps with an Organization API Key, or Settings > Keys & IDs. Set an external_id before adding custom aliases. Conflicting aliases fail without merging users.
delete_user_alias
Remove an external_id or custom alias while retaining the user and subscriptions. The permanent onesignal_id cannot be removed. Use appId from list_apps with an Organization API Key, or Settings > Keys & IDs.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Send push notifications, emails, and SMS/MMS messages. Manage users, aliases, subscriptions, audience segments, message templates, and apps. Retrieve message delivery analytics and downloadable subscription CSV exports. App management and app discovery require an Organization API Key; messaging and audience tools require an App API Key.
Common questions about connecting Onesignal Rest API to AI agents with Metorial.