Dwolla Developers Logo
Back
API Reference
  • SDK Support
    Drop-in Components
    OverviewCreate a client token
    Authorization
    Root
    Accounts
    Customers
    Knowledge-based Authentication (KBA)
    Beneficial Owners
    Documents
    Funding Sources
    Transfers
    Mass payments
    Labels
    Events
    Webhook subscriptions
    Webhooks
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
JavaScript
Get API Keys

Create a client token #

The client token API request requires an action as well as a link which points to the Customer that identifies the end-user performing the action within the drop-in component. The action is a string that contains a granular permission for the Customer performing the action within a drop-in component. Note: This endpoint requires application authorization.

Client token actions

ComponentComponent NamePossible ActionsCreate a Receive-only Userdwolla-customer-createcustomer.createCreate an Unverified Customerdwolla-customer-createcustomer.createUpgrade an Unverified Customerdwolla-customer-updatecustomer.updateCreate a personal Verified Customerdwolla-personal-vcrcustomer.createCreate a business Verified Customerdwolla-business-vcrcustomer.create
businessclassifications.read
customer.read
customer.update
customer.documents.createCreate Beneficial Ownersdwolla-beneficial-ownersbeneficialowners.create
beneficialownership.read
customer.read
beneficialownership.certify
beneficialowners.update
beneficialowner.documents.create
beneficialowner.deleteDocument upload for a Customerdwolla-document-uploadcustomer.documents.createDisplay a Verified Customer’s Balancedwolla-balance-displaycustomer.fundingsources.read

HTTP request

POST https://api.dwolla.com/client-tokens

Request parameters

ParameterRequiredTypeDescriptionactionyesobjectA granular permission for the Customer performing an action within a drop-in component. Reference the client token actions to learn more._linksyesobjectA _links JSON object that contains a link to the desired customer performing the action within the drop-in component.

Request and response

JavaScript
// Using DwollaV2 - https://github.com/Dwolla/dwolla-v2-node
var requestBody = {
  _links: {
    customer: {
      href:
        "https://api-sandbox.dwolla.com/customers/707177c3-bf15-4e7e-b37c-55c3898d9bf4",
    },
  },
  action: "customer.update",
};

dwolla.post("/client-tokens", requestBody).then((res) => res.body.token); // => '4adF858jPeQ9RnojMHdqSD2KwsvmhO7Ti7cI5woOiBGCpH5krY'

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2021 All Rights Reserved

Dwolla

  • About
  • Blog
  • Pricing
  • Contact Sales
  • Terms of Service
  • Privacy Policy
Financial institutions play an important role in our network.

Dwolla, Inc. is the operator of a software platform that communicates user instructions for funds transfers to our financial institution partners.

Dwolla is an agent of Veridian Credit Union. All ACH and Wire transfers are performed by Veridian Credit Union. Your Dwolla Balance, if any, is held in one or more pooled holding accounts held by Veridian Credit Union. These funds may not be eligible for share insurance by the National Credit Union Share Insurance Fund.

Sponsorship and Settlement of Push-to-Debit payment services provided by MetaBank®, N.A.
Push-to-Debit payments are typically available within 30 minutes.

Real-Time Payments are performed by Cross River Bank, which holds funds on behalf of the Receiver of such transactions in one or more pooled custodial accounts. These funds are not subject to FDIC pass-through deposit insurance.