Docs
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 #

ParameterRequiredTypeDescription
idyesstringA 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 StatusCodeDescription
201createdA 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 #

Raw
POST https://api-sandbox.dwolla.com/customers/{id}/labels
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
    "amount": {
        "currency": "USD",
        "value": "10.00"
    }
}

HTTP/1.1 201 Created
Location: https://api-sandbox.dwolla.com/labels/e217bcac-628a-456d-a375-6cc51230616f
Test in the Sandbox for free today.
Use sandbox environment to test API requests.
Get API Keys
2024 All Rights Reserved
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.