AGENT SKILL

pm-sendowl

SendOwl 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-sendowl
description
SendOwl connector knowledge and safe action guide.

02 资源文件 1

03 SKILL.md 正文

pm-sendowl

Purpose

Reads SendOwl orders, products, subscriptions, discounts, bundles, and licenses, and writes product/subscription/discount/bundle lifecycle mutations and order actions (refund, cancel subscription, resend email) through the SendOwl 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
  • mode
  • username (required)
  • password (secret) (required)

ETL Streams

  • orders:
    • primary key: id
    • cursor: created_at
    • fields: buyer_email(string), buyer_name(string), created_at(string), currency(string), id(integer), name(string), price(string), state(string)
  • products:
    • primary key: id
    • fields: created_at(string), currency(string), id(integer), name(string), price(string), product_type(string)
  • subscriptions:
    • primary key: id
    • fields: buyer_email(string), created_at(string), id(integer), name(string), state(string)
  • discounts:
    • primary key: id
    • fields: code(string), created_at(string), currency_code(string), current_uses(integer), discount_flat_rate(string), discount_percentage(string), end_at(string), id(integer), max_uses(integer), start_at(string)
  • bundles:
    • primary key: id
    • fields: created_at(string), currency_code(string), id(integer), name(string), price(string), self_hosted(boolean)
  • licenses:
    • primary key: id
    • fields: created_at(string), id(integer), key(string), product_id(string), status(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Reverse ETL Actions

  • create_product:
    • endpoint: POST /api/v1/products
    • required fields: name
    • risk: creates a new sellable product (no file attachment; SendOwl's file-upload create path is a separate multipart-only endpoint this dialect cannot express, see docs.md Known limits); external mutation, approval required
  • update_product:
    • endpoint: PUT /api/v1/products/{{ record.id }}
    • required fields: id
    • risk: mutates an existing product's name/price/currency; affects future checkouts of this product
  • delete_product:
    • endpoint: DELETE /api/v1/products/{{ record.id }}
    • required fields: id
    • risk: permanently removes a product; breaks any existing order-fulfillment/download links referencing it
  • create_subscription:
    • endpoint: POST /api/v1/subscriptions
    • required fields: name
    • risk: creates a new recurring-billing subscription product; external mutation, approval required
  • update_subscription:
    • endpoint: PUT /api/v1/subscriptions/{{ record.id }}
    • required fields: id
    • risk: mutates an existing subscription's name/price; affects future recurring charges for new subscribers to this plan
  • delete_subscription:
    • endpoint: DELETE /api/v1/subscriptions/{{ record.id }}
    • required fields: id
    • risk: permanently removes a subscription product; does not itself cancel any buyer's already-active recurring order (see cancel_order_subscription)
  • create_discount:
    • endpoint: POST /api/v1_2/discounts
    • required fields: code
    • risk: creates a new discount code usable at checkout; external mutation, approval required
  • update_discount:
    • endpoint: PUT /api/v1_2/discounts/{{ record.id }}
    • required fields: id
    • risk: mutates an existing discount's percentage/usage cap/expiry; affects all buyers subsequently applying this code
  • delete_discount:
    • endpoint: DELETE /api/v1_2/discounts/{{ record.id }}
    • required fields: id
    • risk: permanently removes a discount code; any buyer with the code saved can no longer redeem it
  • update_bundle:
    • endpoint: PUT /api/v1/packages/{{ record.id }}
    • required fields: id
    • risk: mutates an existing bundle's name/price; affects future checkouts of this bundle
  • delete_bundle:
    • endpoint: DELETE /api/v1/packages/{{ record.id }}
    • required fields: id
    • risk: permanently removes a bundle; breaks any existing order-fulfillment links referencing it
  • refund_order:
    • endpoint: POST /api/v1/orders/{{ record.id }}/refund
    • required fields: id, amount
    • optional fields: cancel_subscription, revoke_access
    • risk: issues a real financial refund against the buyer's original payment method; irreversible external money movement, approval required
  • cancel_order_subscription:
    • endpoint: PUT /api/v1/orders/{{ record.id }}/cancel_subscription
    • required fields: id
    • risk: cancels the buyer's active recurring subscription tied to this order; stops future recurring charges, irreversible without the buyer re-subscribing
  • resend_order_email:
    • endpoint: POST /api/v1/orders/{{ record.id }}/resend_email
    • required fields: id
    • optional fields: type
    • risk: resends the order confirmation/receipt/download email to the buyer's address on file; low-risk external side effect, no approval required

Security

  • read risk: external SendOwl API read of order, product, subscription, discount, bundle, and license data
  • write risk: external SendOwl API mutation, including a real financial refund action (refund_order)
  • approval: reverse ETL plan approval required before writes
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect sendowl

Inspect as structured JSON

pm connectors inspect sendowl --json

Agent Rules

  • Run pm connectors inspect sendowl 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