Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Push by Techulus

Scalekit connector
Open markdown

The Push by Techulus connector lets your AI agent act in each user's Push by Techulus account. Each user connects their own Push by Techulus API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 5 tools.

Tools
5
What they doRead · write · destructive
0 · 4 · 10 read4 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 Push by Techulus connection

    In AgentKit > Connections, create a Push by Techulus 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 = 'techuluspush'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Push by Techulus:', 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: 'techuluspush_notification_send',
    toolInput: { title: 'Deploy finished', body: 'Version 1.4.2 is live.' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Push by Techulus 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
  • techuluspush_group_notification_sendSend a push notification to one device group in your Push account.Write

    Send Notification to Device Group

    Send a push notification to one device group in your Push account. Needs the account API key, not a team key. Returns success, a message and per-device delivery results. Use this to target a subset of devices. Use techuluspush_notification_send for all devices.

    Inputs

    bodystringrequired
    Notification body text. Example: Release v2.4.1 is live in production.
    group_idstringrequired
    ID of the device group, from the Push console. Example: 5f1c2b9e-1234-4abc-9def-0123456789ab.
    titlestringrequired
    Notification title. Example: Deploy finished.
    channelstring
    Notification channel, letters, digits and hyphens only. Defaults to feed. Example: deploys.
    imagestring
    URL of an image to show with the notification. Example: https://example.com/images/release.png.
    linkstring
    URL to open when the notification is tapped. Example: https://example.com/releases/2.4.1.
    soundstring
    Notification sound. Example: doorbell.one of defaultarcadecorrectfailharprevealbubbledoorbellflutemoneyscificlearelevatorguitarpop
    time_sensitiveboolean
    Deliver immediately even in Do Not Disturb mode (iOS only). Defaults to false. Example: false.
  • techuluspush_notification_sendSend a push notification to every device in your Push account, or to every team member's devices when the connection uses a team API key.Write

    Send Notification

    Send a push notification to every device in your Push account, or to every team member's devices when the connection uses a team API key. Returns success, a message and per-device delivery results. Use this for up to about 10 devices. Use techuluspush_notification_send_async for teams or more devices, or techuluspush_group_notification_send for one device group.

    Inputs

    bodystringrequired
    Notification body text. Example: Release v2.4.1 is live in production.
    titlestringrequired
    Notification title. Example: Deploy finished.
    channelstring
    Notification channel, letters, digits and hyphens only. Defaults to feed. Example: deploys.
    imagestring
    URL of an image to show with the notification. Example: https://example.com/images/release.png.
    linkstring
    URL to open when the notification is tapped. Example: https://example.com/releases/2.4.1.
    soundstring
    Notification sound. Example: doorbell.one of defaultarcadecorrectfailharprevealbubbledoorbellflutemoneyscificlearelevatorguitarpop
    time_sensitiveboolean
    Deliver immediately even in Do Not Disturb mode (iOS only). Defaults to false. Example: false.
  • techuluspush_notification_send_asyncQueue a push notification for every device in your account or team without waiting for delivery.Write

    Send Notification (Async)

    Queue a push notification for every device in your account or team without waiting for delivery. Returns success and an acknowledgement message, without per-device results. Use this for teams or more than 10 devices. Use techuluspush_notification_send to get delivery results.

    Inputs

    bodystringrequired
    Notification body text. Example: Release v2.4.1 is live in production.
    titlestringrequired
    Notification title. Example: Deploy finished.
    channelstring
    Notification channel, letters, digits and hyphens only. Defaults to feed. Example: deploys.
    imagestring
    URL of an image to show with the notification. Example: https://example.com/images/release.png.
    linkstring
    URL to open when the notification is tapped. Example: https://example.com/releases/2.4.1.
    soundstring
    Notification sound. Example: doorbell.one of defaultarcadecorrectfailharprevealbubbledoorbellflutemoneyscificlearelevatorguitarpop
    time_sensitiveboolean
    Deliver immediately even in Do Not Disturb mode (iOS only). Defaults to false. Example: false.
  • techuluspush_team_member_inviteInvite a person by email to a Push team (Management API, beta).Write

    Invite Team Member

    Invite a person by email to a Push team (Management API, beta). Needs the account API key. Returns success and the message Invite sent. Use this to add someone to a team; once they accept they receive the team's notifications. Use techuluspush_team_member_remove to undo.

    Inputs

    emailstringrequired
    Email address of the person to invite or remove. Example: teammate@example.com.
    teamstringrequired
    API key of the team to change, from the team details screen in Push. Example: team_api_key_from_team_details.
  • techuluspush_team_member_removeRemove a member from a Push team, or revoke a pending invite (Management API, beta).Destructive

    Remove Team Member or Invite

    Remove a member from a Push team, or revoke a pending invite (Management API, beta). Needs the account API key. Returns success and the message Invite/Member removed. Use this to stop someone receiving a team's notifications. Use techuluspush_team_member_invite to add them.

    • Idempotent

    Inputs

    emailstringrequired
    Email address of the person to invite or remove. Example: teammate@example.com.
    teamstringrequired
    API key of the team to change, from the team details screen in Push. Example: team_api_key_from_team_details.