Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Pushover

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Pushover connection

    In AgentKit > Connections, create a Pushover connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'pushover'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'pushover_app_limits_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • pushover_app_limits_getGet the account's monthly message limit, the number of messages sent this month and when the count resets.Read-only

    Get 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-only

    Get 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-only

    List 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-only

    Get 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-only

    Get 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-only

    List 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-only

    Validate 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.Write

    Update 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