Skip to main content
POST
/
customers
/
{id}
cURL
POST https://api-sandbox.dwolla.com/customers/FC451A7A-AE30-4404-AB95-E3553FCD733F
Content-Type: application/json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "johndoe@example.com"
}
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
dwolla
  .post("customers/FC451A7A-AE30-4404-AB95-E3553FCD733F", {
    firstName: "John",
    lastName: "Doe",
    email: "johndoe@example.com"
  })
  .then((res) => res.body);
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
customer = app_token.post('customers/FC451A7A-AE30-4404-AB95-E3553FCD733F', {
    'firstName': 'John',
    'lastName': 'Doe',
    'email': 'johndoe@example.com'
})
customer.body
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$customersApi = new DwollaSwagger\CustomersApi($apiClient);
$customer = $customersApi->updateCustomer("FC451A7A-AE30-4404-AB95-E3553FCD733F", [
    'firstName' => 'John',
    'lastName' => 'Doe',
    'email' => 'johndoe@example.com'
]);
?>
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
customer = app_token.post "customers/FC451A7A-AE30-4404-AB95-E3553FCD733F", {
  firstName: "John",
  lastName: "Doe",
  email: "johndoe@example.com"
}
{
  "_links": {},
  "id": "c41125c5-99c4-4303-a9f6-d066d28a61e3",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "janedoe@mail.com",
  "created": "2022-10-07T16:46:13.023Z",
  "type": "unverified",
  "status": "unverified",
  "correlationId": "CID-abe2bb3d-d2ff-433b-95a3-0debd960ed25",
  "businessName": "Jane Corp llc"
}
{
  "code": "badRequest",
  "message": "Duplicate customer or validation error."
}
{
  "code": "forbidden",
  "message": "Not authorized to update a customer."
}

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

Customer unique identifier

Body

application/json

Parameters for updating a Customer

Deactivate a Customer

​
status
string
required
Example:

"deactivated"

Response

successful operation

Unverified customer - basic customer type with no KYC verification

​
_links
object
required
​
id
string
required
Example:

"c41125c5-99c4-4303-a9f6-d066d28a61e3"

​
firstName
string
required
Example:

"Jane"

​
lastName
string
required
Example:

"Doe"

​
email
string
required
Example:

"janedoe@mail.com"

​
created
string<date-time>
required
Example:

"2022-10-07T16:46:13.023Z"

​
type
enum<string>
required
Available options:
unverified
Example:

"unverified"

​
status
enum<string>
required
Available options:
unverified,
suspended,
deactivated
Example:

"unverified"

​
correlationId
string
Example:

"CID-abe2bb3d-d2ff-433b-95a3-0debd960ed25"

​
businessName
string
Example:

"Jane Corp llc"