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 #

Parameter	Required	Type	Description
id	yes	string	A Customer's unique identifier.
amount	yes	object	Amount of funds to label for a Verified Customer. An amount object. Reference the amount object to learn more.

HTTP status and error codes #

HTTP Status	Code	Description
201	created	A Label was created.
400	ValidationError	Required - Field is required. InvalidFormat - InvalidFormat. Invalid - Amount can not cause label balance to be negative.
403	NotAuthorized	Not authorized to create Labels. Contact us to enable this functionality.
404	NotFound	Customer 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

Overview

Retrieve a label

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys

Dwolla

Product

Developers

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.