Dwolla Developers Logo
Back
API Reference
  • SDK Support
    Drop-in Components
    Authorization
    Root
    Accounts
    Customers
    Knowledge-based Authentication (KBA)
    Beneficial Owners
    Documents
    Funding Sources
    Transfers
    Mass payments
    Labels
    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
    Events
    Webhook subscriptions
    Webhooks
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
JavaScript
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 #

JavaScript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var customerUrl =
  "https://api-sandbox.dwolla.com/customers/AB443D36-3757-44C1-A1B4-29727FB3111C";
var requestBody = {
  amount: {
    currency: "USD",
    value: "10.00",
  },
};

dwolla
  .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

Dwolla

  • 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.