Create a product

Authorization

apiKey

AuthorizationBearer <token>

BAGS Agent API key from the dashboard. Standalone agentic keys manage products, payment links, and transaction reads.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Lengthlength <= 200

description?|null

amount*string|number

currency?string

Default"USD"

Value in"USD"

pricingType?string

Default"one_time"

Value in"one_time" | "recurring"

pricing_type?string

Default"one_time"

Value in"one_time" | "recurring"

billingInterval?string

Value in"minute" | "week" | "month" | "year"

billing_interval?string

Value in"minute" | "week" | "month" | "year"

billingIntervalCount?integer

Range1 <= value <= 12

billing_interval_count?integer

Range1 <= value <= 12

trialDays?integer

Range0 <= value <= 365

trial_days?integer

Range0 <= value <= 365

token?string

Default"USDC"

Value in"USDC" | "USDT" | "SOL" | "ETH" | "MATIC" | "POL"

merchantWalletAddress?string

Length32 <= length <= 128

merchant_wallet_address?string

Length32 <= length <= 128

mode?string

Value in"live" | "test"

curl -X POST "https://www.getbags.app/api/v1/products" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "amount": "string"  }'

{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Pro Plan",
    "description": "Monthly access to premium features",
    "amount": 29.99,
    "currency": "USD",
    "active": true,
    "archived": false,
    "mode": "live",
    "pricingType": "recurring",
    "billingInterval": "month",
    "billingIntervalCount": 1,
    "trialDays": 14,
    "token": "USDC",
    "merchantWalletAddress": "0x1111111111111111111111111111111111111111",
    "merchantId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "metadata": {},
    "totalCollected": 0,
    "totalTransactions": 0,
    "createdAt": "2026-04-16T12:34:56.000Z",
    "updatedAt": "2026-04-16T12:34:56.000Z"
  }
}

{
  "status": "error",
  "code": "VALIDATION_FAILED",
  "message": "One or more fields failed validation."
}

{
  "status": "error",
  "code": "AUTH_MISSING_CREDENTIALS",
  "message": "No API key or session token was provided.",
  "hint": "Include a valid API key in the Authorization header: Bearer bag_live_sk_..."
}

{
  "status": "error",
  "code": "AUTH_TENANT_MISMATCH",
  "message": "The credential does not grant access to this resource."
}

{
  "status": "error",
  "code": "TRANSACTION_CHAIN_VERIFY_FAILED",
  "message": "On-chain verification failed for the supplied txHash."
}

{
  "status": "error",
  "code": "RATE_LIMITED",
  "message": "Too many requests. Back off and retry.",
  "retryAfter": 60
}

{
  "status": "error",
  "code": "INTERNAL_ERROR",
  "message": "An unexpected error occurred. The incident has been logged."
}