Dwolla Developers Logo
API Reference
  • SDK Support
    Drop-in Components
    Knowledge-based Authentication (KBA)
    Beneficial Owners
    Funding Sources
    Mass payments
    OverviewCreate a labelRetrieve a labelCreate a label ledger entryRetrieve a label ledger entryList label ledger entriesList labels for a customerCreate a label reallocationRetrieve a label reallocationRemove a label
    Webhook subscriptions
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
Get API Keys

Create a label #

This section outlines how to create a new Label. When creating a Label you’ll specify an amount as well as the ID of a Verified Customer that the label is tied to. Upon success, the API will return a 201 with a link to the created Label resource in the location header.

HTTP request #

POST https://api.dwolla.com/customers/{id}/labels

Request parameters #

ParameterRequiredTypeDescriptionidyesstringA Customer's unique identifier.amountyesobjectAmount of funds to label for a Verified Customer. An amount object. Reference the amount object to learn more.

HTTP status and error codes #

HTTP StatusCodeDescription201createdA Label was created.400ValidationErrorRequired - Field is required.
InvalidFormat - InvalidFormat.
Invalid - Amount can not cause label balance to be negative.403NotAuthorizedNot authorized to create Labels. Contact us to enable this functionality.404NotFoundCustomer not found. Check CustomerId.

Request and response #

// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var customerUrl =
var requestBody = {
  amount: {
    currency: "USD",
    value: "10.00",

  .post(`${customerUrl}/labels`, requestBody)
  .then((res) => res.headers.get("location")); // => 'https://api-sandbox.dwolla.com/labels/375c6781-2a17-476c-84f7-db7d2f6ffb31'

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2022 All Rights Reserved


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

All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.