AGENT SKILL

pm-younium

Younium connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-younium
description
Younium connector knowledge and safe action guide.

02 资源文件 1

03 SKILL.md 正文

pm-younium

Purpose

Reads and writes Younium accounts, subscriptions, invoices, products, payment terms, currencies, and webhooks through the Younium REST API.

Icon

Capabilities

  • check=true catalog=true read=true write=true query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • base_url
  • legal_entity
  • mode
  • username (required)
  • password (secret) (required)

ETL Streams

  • accounts:
    • primary key: id
    • cursor: updated_at
    • fields: account_id(string), id(string), name(string), updated_at(string)
  • subscriptions:
    • primary key: id
    • cursor: updated_at
    • fields: account_id(string), id(string), name(string), updated_at(string)
  • invoices:
    • primary key: id
    • cursor: updated_at
    • fields: account_id(string), id(string), name(string), updated_at(string)
  • products:
    • primary key: id
    • fields: id(string), name(string), updated_at(string)
  • payment_terms:
    • primary key: id
    • fields: id(string), name(string)
  • currencies:
    • primary key: id
    • fields: id(string), name(string)
  • webhooks:
    • primary key: id
    • fields: id(string), name(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Reverse ETL Actions

  • create_account:
    • endpoint: POST /Accounts
    • required fields: name, currency
    • risk: creates a new billing account in Younium; external mutation, approval required
  • update_account:
    • endpoint: PATCH /Accounts/{{ record.id }}
    • required fields: id
    • risk: mutates an existing account's billing/contact/tax metadata; external mutation, approval required
  • cancel_subscription:
    • endpoint: POST /Subscriptions/cancel/{{ record.id }}
    • required fields: id, cancellationDate, cancellationMode
    • risk: irreversibly schedules or immediately cancels an active subscription, ending future billing; external mutation, approval required
  • post_invoice:
    • endpoint: POST /Invoices/{{ record.id }}/post
    • required fields: id
    • risk: finalizes a draft invoice, making it official/sendable to the customer; external mutation, approval required
  • cancel_invoice:
    • endpoint: POST /Invoices/{{ record.id }}/cancel
    • required fields: id
    • risk: irreversibly cancels a posted invoice; external mutation, approval required

Security

  • read risk: external Younium API read of account, subscription, invoice, product, payment term, currency, and webhook data
  • write risk: external mutation of billing-critical Younium records: account create/update, subscription cancellation (ends future billing), and invoice posting/cancellation
  • approval: required for all write actions; cancel_subscription and cancel_invoice require explicit destructive confirmation
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect younium

Inspect as structured JSON

pm connectors inspect younium --json

Agent Rules

  • Run pm connectors inspect younium before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.
  • For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.

04 同仓库更多 Skills