Lectful Central icon

Lectful Central

Interact with the Lectful Central API for admin operations

Actions63

Overview

This node integrates with the Lectful Central API to perform administrative operations related to subscription management, among other resources. Specifically, for the Subscription Management resource and the List Prices operation, it retrieves a paginated list of all prices associated with subscription plans. This is useful for scenarios where you want to fetch pricing details programmatically, such as displaying available subscription prices in a custom dashboard, syncing price data with other systems, or automating billing workflows.

Practical example:

  • An e-commerce platform using Lectful for subscriptions can use this node to list all active prices for their plans and update their storefront dynamically.
  • A finance team could automate reports on subscription pricing tiers by fetching this data regularly.

Properties

Name Meaning
Authentication Mode Choose how to authenticate with the Lectful Central API:
- Use Stored Credentials
- Manual Configuration (provide base URL and API key manually)
Base URL Override Optional base URL to override the credential setting (without /api/v1). Required if using Manual Configuration mode.
API Key Override Optional API key to override the credential setting. Required if using Manual Configuration mode.

Additional parameters specific to the List Prices operation under Subscription Management (inherited from general pagination/filtering properties):

Name Meaning
Page Page number for pagination (default: 1).
Per Page Number of items per page (default: 15).
Plan ID Optional filter to list prices only for a specific plan ID (default: 0 means no filter).

Output

The output is an array of JSON objects representing the API response for the list of prices. Each item corresponds to a price entry retrieved from the Lectful Central API. The structure typically includes fields such as price ID, name, description, amount, currency, pricing model, billing period, trial period, active status, and associated plan ID.

Example output snippet (conceptual): 

[
  {
    "id": 123,
    "name": "Basic Monthly",
    "description": "Monthly subscription for basic plan",
    "amount": 2999,
    "currency": "USD",
    "pricing_model": "flat_fee",
    "period_unit": "month",
    "period": 1,
    "trial_period": 14,
    "is_active": true,
    "priceable_id": 45
  },
  ...
]

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Lectful Central API endpoint.
  • Requires authentication via either stored credentials configured in n8n or manual input of Base URL and API key.
  • The node expects the API to be reachable at {Base URL}/api/v1.
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Missing or invalid credentials:
    Error message: "Valid credentials are required when using 'Use Stored Credentials' mode. Please configure Lectful API credentials in the credentials field above or switch to Manual Configuration mode."
    Resolution: Ensure that valid API credentials are configured in n8n or provide them manually.

  • Manual configuration missing parameters:
    Error message: "Base URL Override is required when using Manual Configuration mode" or "API Key Override is required when using Manual Configuration mode"
    Resolution: Provide both Base URL Override and API Key Override when using manual authentication mode.

  • API request failures:
    Could be due to network issues, incorrect API keys, or API endpoint changes. Check the Base URL and API key correctness, and verify API availability.

  • Pagination parameters ignored or invalid:
    Ensure Page and Per Page values are positive integers. Invalid values may cause unexpected results or errors.

Links and References

Discussion