Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Flutterwave

Scalekit connector
Open markdown

The Flutterwave connector lets your AI agent act in each user's Flutterwave account. Each user connects their own Flutterwave access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
37 · 20 · 337 read20 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Flutterwave connection

    In AgentKit > Connections, create a Flutterwave connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'flutterwave'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Flutterwave:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'flutterwave_balances_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Flutterwave credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • flutterwave_balance_getGet your available and ledger balance in one currency.Read-only

    Get Wallet Balance

    Get your available and ledger balance in one currency.

    Inputs

    currencystringrequired
    ISO 4217 currency code. Example: NGN.
  • flutterwave_balances_listGet your available and ledger balance in every currency wallet.Read-only

    List Wallet Balances

    Get your available and ledger balance in every currency wallet.

    Inputs

    This tool takes no inputs.

  • flutterwave_bank_account_resolveLook up the account holder name of a bank account number before sending a transfer.Read-only

    Resolve Bank Account Name

    Look up the account holder name of a bank account number before sending a transfer. Returns account_number and account_name.

    Inputs

    account_bankstringrequired
    The Customer's Bank code. See full list of bank codes here. Example: 044.
    account_numberstringrequired
    The Customer's Bank account number. Example: 0690000032.
  • flutterwave_bank_branches_listList the branches of a bank with their branch codes (needed for transfers in some countries).Read-only

    List Bank Branches

    List the branches of a bank with their branch codes (needed for transfers in some countries).

    Inputs

    idintegerrequired
    The Bank's unique ID returned in the fetch response. Example: 280.
  • flutterwave_banks_listList the banks supported in a country with their codes.Read-only

    List Banks

    List the banks supported in a country with their codes. Use the code as account_bank in transfers and account lookups.

    Inputs

    countrystringrequired
    ISO-2 country code e.g. NG. Example: NG.
    include_provider_typestring
    This introduces a field that helps differentiate between a bank and mobile money provider. Example: 1.
  • flutterwave_beneficiaries_listList saved transfer beneficiaries.Read-only

    List Beneficiaries

    List saved transfer beneficiaries. Returns per beneficiary its id, account number, bank and name. Results are paged; pass page for the next page.

    Inputs

    pageinteger
    This is the page number to retrieve e.g. setting 1 retrieves the first page. Example: 1.
  • flutterwave_beneficiary_getGet one transfer beneficiary by ID.Read-only

    Get Beneficiary

    Get one transfer beneficiary by ID.

    Inputs

    idintegerrequired
    This is the unique identifier for the beneficiary you intend to fetch. It is returned in the call to create a beneficiary as data.id. Example: 3644.
  • flutterwave_bill_categories_listList the bill categories (airtime, data, cable, power and others) you can pay in a country.Read-only

    List Bill Categories

    List the bill categories (airtime, data, cable, power and others) you can pay in a country. Returns per category its code and name.

    Inputs

    countrystring
    This is the country of the Biller. The expected value is NG. Example: NG.