The Pushover connector lets your AI agent act in each user's Pushover account. Each user connects their own Pushover API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 18 tools.
- Tools
- 18
- What they doRead · write · destructive
- 7 · 10 · 17 read10 write1 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Pushover connection
In AgentKit > Connections, create a Pushover connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'pushover'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Pushover:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'pushover_app_limits_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "pushover"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Pushover:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="pushover_app_limits_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Pushover credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolpushover_app_limits_getGet the account's monthly message limit, the number of messages sent this month and when the count resets.Read-onlyGet Message Limits
Get the account's monthly message limit, the number of messages sent this month and when the count resets. Returns limit, remaining and reset (Unix timestamp). Use pushover_app_limits_get before bulk sends to avoid 429 errors.
Inputs
This tool takes no inputs.
pushover_group_getGet a delivery group's name and members.Read-onlyGet Delivery Group
Get a delivery group's name and members. Returns the name and each member's user key, device, memo and disabled flag. Use pushover_group_get to see who receives a group's messages.
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
pushover_groups_listList the account's delivery groups.Read-onlyList Delivery Groups
List the account's delivery groups. Returns each group's key and name. Use pushover_groups_list to find a group key. Send to a group by passing its key as user in pushover_message_send.
Inputs
This tool takes no inputs.
pushover_licenses_credits_getGet the number of prepaid Pushover license credits left on the account.Read-onlyGet License Credits
Get the number of prepaid Pushover license credits left on the account. Returns credits. Use pushover_licenses_credits_get before pushover_license_assign.
Inputs
This tool takes no inputs.
pushover_receipt_getGet the status of an emergency-priority message by its receipt; poll no more than once every 5 seconds, for up to a week.Read-onlyGet Receipt
Get the status of an emergency-priority message by its receipt; poll no more than once every 5 seconds, for up to a week. Returns acknowledged, acknowledged_at and _by, last_delivered_at, expired, expires_at and callback status. Use pushover_receipt_get to see whether someone acknowledged an alert. Use pushover_receipt_cancel to stop its repeats.
Inputs
receiptstringrequired- Receipt ID returned when an emergency-priority (priority 2) message was sent. Example: rLqVuqTRh62UzxtmqiaLzQmVcPgiCy
pushover_sounds_listList the notification sounds available to the application, including custom sounds uploaded to the account.Read-onlyList Sounds
List the notification sounds available to the application, including custom sounds uploaded to the account. Returns a map of sound IDs to display names. Use pushover_sounds_list to pick a sound for pushover_message_send.
Inputs
This tool takes no inputs.
pushover_user_validateCheck that a user or group key is valid and has at least one active device (or the named device).Read-onlyValidate User
Check that a user or group key is valid and has at least one active device (or the named device). Returns status 1 with the user's active device names and licensed platforms, or status 0 with the problem. Use pushover_user_validate when collecting a user key, before sending to it.
Inputs
userstringrequired- Recipient's Pushover user key or a delivery group key (30 characters, from the user's dashboard). Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
devicestring- Device name to validate as well. Example: iphone
pushover_glance_updateUpdate the data shown on a user's Pushover widget (Apple Watch complication) without sending a notification; fields not sent keep their value and an empty string clears one.WriteUpdate Glance
Update the data shown on a user's Pushover widget (Apple Watch complication) without sending a notification; fields not sent keep their value and an empty string clears one. Updates can take up to 10 minutes to appear. Returns status 1. Use pushover_glance_update for a live number or status on a watch. Use pushover_message_send for alerts.
- Idempotent
Inputs
userstringrequired- Recipient's Pushover user key or a delivery group key (30 characters, from the user's dashboard). Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
countinteger- A number for small screens; may be negative. Example: 1204
devicestring- Device name to send to only that device (comma-separate several); leave empty for all of the user's devices. Example: iphone
percentinteger- 0 to 100, shown as a progress ring. Example: 64
subtextstring- Second line, up to 100 characters. Example: +12% vs yesterday
textstring- Main line, up to 100 characters. Example: 1,204 today
titlestring- Description of the data, up to 100 characters. Example: Widgets sold
pushover_group_createCreate a delivery group.WriteCreate Delivery Group
Create a delivery group. Returns the new group key. Use pushover_group_create to broadcast to several users with one key, then add members with pushover_group_user_add.
Inputs
namestringrequired- Group name, unique in the account. Example: On-call engineers
pushover_group_renameRename a delivery group.WriteRename Delivery Group
Rename a delivery group. Returns status 1. Use pushover_group_rename to change a group's name.
- Idempotent
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
namestringrequired- New group name, unique in the account. Example: Primary on-call
pushover_group_user_addAdd a Pushover user to a delivery group.WriteAdd Group Member
Add a Pushover user to a delivery group. Returns status 1. Use pushover_group_user_add to add someone to a broadcast group. Use pushover_group_user_remove to take them out.
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
userstringrequired- The member's Pushover user key. Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
devicestring- Restrict the member's messages to this device. Example: iphone
memostring- Free-text note about the member, such as their name (up to 200 characters). Example: Jim (SRE)
pushover_group_user_disableTemporarily stop sending a group's messages to one member.WriteDisable Group Member
Temporarily stop sending a group's messages to one member. Returns status 1. Use pushover_group_user_disable for someone going off call. Use pushover_group_user_enable to resume.
- Idempotent
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
userstringrequired- The member's Pushover user key. Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
devicestring- Only disable the membership for this device. Example: iphone
pushover_group_user_enableResume sending a group's messages to a disabled member.WriteEnable Group Member
Resume sending a group's messages to a disabled member. Returns status 1. Use pushover_group_user_enable to undo pushover_group_user_disable.
- Idempotent
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
userstringrequired- The member's Pushover user key. Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
devicestring- Only enable the membership for this device. Example: iphone
pushover_license_assignAssign one prepaid Pushover license to a user by user key or email, optionally for one platform; uses one license credit.WriteAssign License
Assign one prepaid Pushover license to a user by user key or email, optionally for one platform; uses one license credit. Returns status 1 and the remaining credits. Use pushover_license_assign to give your users Pushover without them paying. Check credits with pushover_licenses_credits_get.
Inputs
emailstring- The user's email, which creates an account if needed; give this or user. Example: jane@example.com
osstring- Platform to license: Android, iOS or Desktop; leave empty for the first platform the user registers. One of: Android, iOS, Desktop. Example: iOSone of
AndroidiOSDesktop userstring- The user's Pushover user key; give this or email. Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
pushover_message_sendSend a push notification to a Pushover user or delivery group, with optional title, link, priority, sound, HTML, image and expiry.WriteSend Notification
Send a push notification to a Pushover user or delivery group, with optional title, link, priority, sound, HTML, image and expiry. Messages are limited to 1024 characters; each successful send counts against the account's monthly quota. Returns status 1 and a request ID, plus a receipt for emergency-priority messages. Use pushover_message_send to alert someone's phone or desktop. Use pushover_receipt_get to check whether an emergency message was acknowledged.
Inputs
messagestringrequired- Message body, up to 1024 characters; set html to 1 to allow basic HTML. Example: Backup of database "example" finished in 16 minutes.
userstringrequired- Recipient's Pushover user key or a delivery group key (30 characters, from the user's dashboard). Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
attachment_base64string- Image attachment as base64 (up to 5 MB); set attachment_type too. Example: iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==
attachment_typestring- MIME type of attachment_base64, such as image/jpeg or image/png. Example: image/png
callbackstring- For priority 2: URL Pushover POSTs to when the message is acknowledged. Example: https://example.com/pushover/ack
devicestring- Device name to send to only that device (comma-separate several); leave empty for all of the user's devices. Example: iphone
expireinteger- For priority 2: seconds to keep repeating, at most 10800. Example: 3600
htmlinteger- 1 to enable HTML formatting. One of: 0, 1. Example: 1one of
01 monospaceinteger- 1 to show the message in a monospace font (not with html). One of: 0, 1. Example: 0one of
01 priorityinteger- -2 (no alert), -1 (quiet), 0 (default), 1 (high, bypasses quiet hours) or 2 (emergency, repeats until acknowledged; needs retry and expire). One of: -2, -1, 0, 1, 2. Example: 0one of
-2-1012 retryinteger- For priority 2: seconds between repeats, at least 30. Example: 60
soundstring- Sound name from pushover_sounds_list, overriding the user's default. Example: magic
tagsstring- For priority 2: comma-separated tags for cancelling with pushover_receipts_cancel_by_tag. Example: server=mail01,dc=chicago
timestampinteger- Unix timestamp to show instead of the time Pushover received the message. Example: 1763280000
titlestring- Title, up to 250 characters; defaults to the app's name. Example: Backup finished - SQL1
ttlinteger- Seconds after which the message is deleted from devices (ignored for priority 2). Example: 3600
urlstring- Supplementary URL shown under the message, up to 512 characters. Example: https://status.example.com/incidents/42
url_titlestring- Title for the supplementary URL, up to 100 characters. Example: View incident
pushover_receipt_cancelStop the repeats of an emergency-priority message before it expires.WriteCancel Emergency Retries
Stop the repeats of an emergency-priority message before it expires. Returns status 1. Use pushover_receipt_cancel when the issue is resolved. Use pushover_receipts_cancel_by_tag to cancel many messages at once.
- Idempotent
Inputs
receiptstringrequired- Receipt ID returned when an emergency-priority (priority 2) message was sent. Example: rLqVuqTRh62UzxtmqiaLzQmVcPgiCy
pushover_receipts_cancel_by_tagStop the repeats of every active emergency-priority message sent by the application with a given tag.WriteCancel Emergency Retries by Tag
Stop the repeats of every active emergency-priority message sent by the application with a given tag. Returns status 1 and the number of messages cancelled. Use pushover_receipts_cancel_by_tag to clear a batch of related alerts, such as all alerts for one datacenter.
- Idempotent
Inputs
tagstringrequired- Tag the messages were sent with. Example: dc=chicago
pushover_group_user_removeRemove a user from a delivery group.DestructiveRemove Group Member
Remove a user from a delivery group. Returns status 1. Use pushover_group_user_remove to take someone out. Use pushover_group_user_disable to pause them instead.
- Idempotent
Inputs
group_keystringrequired- Delivery group key, from pushover_groups_list or pushover_group_create. Example: go4abk17j3itsva6thz99mdudgq2gm
userstringrequired- The member's Pushover user key. Example: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
devicestring- Only remove the membership for this device. Example: iphone
No tools match.