View as Markdown
Papertrail icon

Papertrail ACTION

Register System

Create a new log sender. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Papertrail account once, then configure and run Register System from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "papertrail-register-system",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    papertrail: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    hostname: "Hostname",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Register System inputs
Property Type Description
name Name string
Display name of the system in Papertrail
Required
hostname Hostname string
Syslog hostname filter (required when using a log destination). Events from other hostnames may be dropped when set.
Optional
ipAddress IP Address string
Source IP for standard syslog (port 514). Use this flow when not using a custom destination.
Optional
destinationId Destination ID string
Log destination ID from your Papertrail account
Optional
destinationPort Destination Port string
Destination port number (alternative to Destination ID)
Optional
description Description string
Optional freeform description
Optional
autoDelete Auto Delete boolean
Whether Papertrail may automatically remove the system when idle (default follows destination or API default)
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
papertrail-register-system
Version
0.0.1
App
Papertrail
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes