Create a label for a customer

Creates a new label for a Verified Customer with a specified amount. Labels help organize and track funds within a customer’s balance. Returns the location of the created label resource in the response header.

POST /customers/{id}/labels

cURL

cURL

POST https://api-sandbox.dwolla.com/customers/AB443D36-3757-44C1-A1B4-29727FB3111C/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"
    }
}

400

{
  "code": "BadRequest",
  "message": "The request body contains bad syntax or is incomplete."
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Accept · enum<string> · default: application/vnd.dwolla.v1.hal+json · required

The media type of the response. Must be application/vnd.dwolla.v1.hal+json

Available options: application/vnd.dwolla.v1.hal+json

Path Parameters

id · string · required

ID of customer to create a label for

Body

application/json

Parameters to create a customer label

amount · object · required

Show child attributes

Response

201

create