Skip to main content

Get User Subscription Info

Retrieves detailed subscription information including usage limits, character quotas, and plan details.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs​

  • Connection Id (String) - Connection ID from the Connect node. Optional if you provide API Key directly.

Options​

  • API Key - Your ElevenLabs AI API key. Optional if using Connection ID.

Outputs​

  • User Subscription Info (Object) - Detailed subscription information including:
    • tier - Subscription tier/plan name
    • character_count - Characters used in current period
    • character_limit - Total character limit for the period
    • can_extend_character_limit - Whether limit can be extended
    • allowed_to_extend_character_limit - Permission to extend limit
    • next_character_count_reset_unix - When quota resets (Unix timestamp)
    • voice_limit - Maximum number of custom voices allowed
    • professional_voice_limit - Professional voice limit
    • can_use_instant_voice_cloning - Instant voice cloning capability
    • can_use_professional_voice_cloning - Professional voice cloning capability
    • status - Subscription status (active, cancelled, etc.)

How It Works​

The Get User Subscription Info node retrieves subscription details. When executed, the node:

  1. Either uses the provided connection or creates a new client with direct API key
  2. Calls the ElevenLabs API to retrieve subscription information
  3. Returns detailed quota, usage, and plan information

Requirements​

  • Valid ElevenLabs API key (via Connect node or direct option)

Error Handling​

The node will return an error in the following case:

  • Retrieval failure - "Failed to retrieve user subscription info: [error details]"

Usage Notes​

  • Returns detailed usage and quota information
  • Character count shows current billing period usage
  • Character limit shows maximum allowed characters
  • Next reset timestamp shows when quota will refresh
  • Voice limits indicate how many custom voices you can create
  • Useful for monitoring usage to avoid exceeding limits
  • Check this before large batch operations
  • Different tiers have different capabilities and limits
  • Can use this to implement usage-based logic in automations

Example Use Cases​

  • Monitoring character usage to stay within quota
  • Checking remaining character quota before batch processing
  • Verifying subscription tier and capabilities
  • Building usage dashboards and reports
  • Implementing quota warnings in automations
  • Planning large-scale audio generation projects
  • Checking when quota will reset
  • Validating account has required features (e.g., voice cloning)
  • Managing costs by tracking usage