Add-Ons

addon_id

string · required

Addon item price ID (e.g., additional-custom-domain)

quantity

integer · required

New quantity for the addon

Update addon quantity (deprecated) › Responses

Addon updated successfully

success

boolean

POST/addons

curl --request POST \
  --url https://api.funnelflux.pro/v1/billing/addons \
  --header 'Content-Type: application/json' \
  --data '
{
  "addon_id": "addon_id",
  "quantity": 0
}
'

Example Request Body

{
  "addon_id": "addon_id",
  "quantity": 0
}

json

Example Responses

{
  "success": true,
  "subscription": {
    "owner_id": "owner_id",
    "status": "active",
    "plan": {
      "id": "id",
      "name": "name",
      "tier": "tier"
    },
    "features": {
      "features": {
        "key": {
          "plan": "plan",
          "level": 0
        }
      }
    },
    "mrr": 0,
    "next_billing_at": 0,
    "current_term_start": 0,
    "current_term_end": 0,
    "trial_start": 0,
    "trial_end": 0,
    "cancelled_at": 0,
    "has_scheduled_changes": true,
    "subscription_items": [
      {
        "item_price_id": "item_price_id",
        "item_type": "plan",
        "quantity": 0,
        "unit_price": 0,
        "trial_end": 0,
        "is_in_trial": true,
        "trial_days_remaining": 0
      }
    ],
    "coupons": [
      {
        "coupon_id": "coupon_id"
      }
    ],
    "created_at": 0,
    "chargebee_customer_id": "chargebee_customer_id",
    "chargebee_subscription_id": "chargebee_subscription_id",
    "pause_date": 0,
    "resume_date": 0,
    "email": "email",
    "name": "name",
    "billing_country": "billing_country"
  }
}

json

application/json

Update addon quantity

POST

https://api.funnelflux.pro/v1/billing

/addons/quantity

Updates the quantity of an addon in the user's subscription.

Update addon quantity › Request Body

addon_id

string · required

Addon item price ID (e.g., additional-custom-domain)

quantity

integer · required

New quantity for the addon

Update addon quantity › Responses

Addon updated successfully

success

boolean

POST/addons/quantity

curl --request POST \
  --url https://api.funnelflux.pro/v1/billing/addons/quantity \
  --header 'Content-Type: application/json' \
  --data '
{
  "addon_id": "addon_id",
  "quantity": 0
}
'

Example Request Body

{
  "addon_id": "addon_id",
  "quantity": 0
}

json

Example Responses

{
  "success": true,
  "subscription": {
    "owner_id": "owner_id",
    "status": "active",
    "plan": {
      "id": "id",
      "name": "name",
      "tier": "tier"
    },
    "features": {
      "features": {
        "key": {
          "plan": "plan",
          "level": 0
        }
      }
    },
    "mrr": 0,
    "next_billing_at": 0,
    "current_term_start": 0,
    "current_term_end": 0,
    "trial_start": 0,
    "trial_end": 0,
    "cancelled_at": 0,
    "has_scheduled_changes": true,
    "subscription_items": [
      {
        "item_price_id": "item_price_id",
        "item_type": "plan",
        "quantity": 0,
        "unit_price": 0,
        "trial_end": 0,
        "is_in_trial": true,
        "trial_days_remaining": 0
      }
    ],
    "coupons": [
      {
        "coupon_id": "coupon_id"
      }
    ],
    "created_at": 0,
    "chargebee_customer_id": "chargebee_customer_id",
    "chargebee_subscription_id": "chargebee_subscription_id",
    "pause_date": 0,
    "resume_date": 0,
    "email": "email",
    "name": "name",
    "billing_country": "billing_country"
  }
}

json

application/json

Switch addon tier

POST

https://api.funnelflux.pro/v1/billing

/addons/switch

Switches between addon tiers (e.g., ai-nodes-basic -> ai-nodes-pro). Can be used to add a new addon, switch tiers, or remove an addon entirely.

Switch addon tier › Request Body

SwitchAddonTierRequest

current_addon_id

string

Current addon to remove (null if adding new)

new_addon_id

string

New addon to add (null if removing entirely)

invoice_immediately

boolean

Generate prorated invoice immediately (default true)

Default: true

Switch addon tier › Responses

Addon tier switched successfully

SwitchAddonTierResponse

success

boolean

POST/addons/switch

curl --request POST \
  --url https://api.funnelflux.pro/v1/billing/addons/switch \
  --header 'Content-Type: application/json' \
  --data '
{
  "current_addon_id": "current_addon_id",
  "new_addon_id": "new_addon_id",
  "invoice_immediately": true
}
'

Example Request Body

{
  "current_addon_id": "current_addon_id",
  "new_addon_id": "new_addon_id",
  "invoice_immediately": true
}

json

Example Responses

{
  "success": true,
  "subscription": {
    "owner_id": "owner_id",
    "status": "active",
    "plan": {
      "id": "id",
      "name": "name",
      "tier": "tier"
    },
    "features": {
      "features": {
        "key": {
          "plan": "plan",
          "level": 0
        }
      }
    },
    "mrr": 0,
    "next_billing_at": 0,
    "current_term_start": 0,
    "current_term_end": 0,
    "trial_start": 0,
    "trial_end": 0,
    "cancelled_at": 0,
    "has_scheduled_changes": true,
    "subscription_items": [
      {
        "item_price_id": "item_price_id",
        "item_type": "plan",
        "quantity": 0,
        "unit_price": 0,
        "trial_end": 0,
        "is_in_trial": true,
        "trial_days_remaining": 0
      }
    ],
    "coupons": [
      {
        "coupon_id": "coupon_id"
      }
    ],
    "created_at": 0,
    "chargebee_customer_id": "chargebee_customer_id",
    "chargebee_subscription_id": "chargebee_subscription_id",
    "pause_date": 0,
    "resume_date": 0,
    "email": "email",
    "name": "name",
    "billing_country": "billing_country"
  }
}

json

application/json

Usage Domains

Update addon quantity (deprecated)

POST

https://api.funnelflux.pro/v1/billing

/addons

Deprecated compatibility alias for /addons/quantity. New clients must call /addons/quantity.

Update addon quantity (deprecated) › Request Body

addon_id

string · required

Addon item price ID (e.g., additional-custom-domain)

quantity

integer · required

New quantity for the addon

Update addon quantity (deprecated) › Responses

Addon updated successfully

success

boolean

Update addon quantity

POST

https://api.funnelflux.pro/v1/billing

/addons/quantity

Updates the quantity of an addon in the user's subscription.

Update addon quantity › Request Body

addon_id

string · required

Addon item price ID (e.g., additional-custom-domain)

quantity

integer · required

New quantity for the addon

Update addon quantity › Responses

Addon updated successfully

success

boolean

Switch addon tier

POST

https://api.funnelflux.pro/v1/billing

/addons/switch

Switches between addon tiers (e.g., ai-nodes-basic -> ai-nodes-pro). Can be used to add a new addon, switch tiers, or remove an addon entirely.

Switch addon tier › Request Body

SwitchAddonTierRequest

current_addon_id

string

Current addon to remove (null if adding new)

new_addon_id

string

New addon to add (null if removing entirely)

invoice_immediately

boolean

Generate prorated invoice immediately (default true)

Default: true

Switch addon tier › Responses

Addon tier switched successfully

SwitchAddonTierResponse

success

boolean