Each webhook sent by the Dwolla API contains an Event with _links to: the associated resource, account associated with the event, and the customer associated with the event (if applicable). It is important to note that a single API request can trigger multiple webhooks to be fired, e.g. initiating a transfer from an Account to Customer can create the events transfer_created and customer_transfer_created.
Reference additional information on account types in this resource article.
Description: An account was suspended.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the AccountInfoFull
permission in order to receive this event.
{
"id": "43706141-18a2-457e-96fc-8d26864825b7",
"resourceId": "6238fb83-b45a-4853-90f9-0a58bf54bf32",
"topic": "account_suspended",
"timestamp": "2017-01-20T17:53:33.802Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/43706141-18a2-457e-96fc-8d26864825b7"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
}
},
"created": "2017-01-20T17:53:33.802Z"
}
Description: A Dwolla account moves from deactive or suspended to active state of verification.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the AccountInfoFull
permission in order to receive this event.
{
"id": "4850dfff-2ea7-4827-ae14-7adb1de6585b",
"resourceId": "6238fb83-b45a-4853-90f9-0a58bf54bf32",
"topic": "account_activated",
"timestamp": "2017-01-20T17:53:56.502Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/4850dfff-2ea7-4827-ae14-7adb1de6585b"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
}
},
"created": "2017-01-20T17:53:56.502Z"
}
Description: A funding source (Bank Account) was added to a Dwolla account.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "d2ca4bb9-bcec-49dc-8934-e4f086e1eba2",
"resourceId": "487cb8c8-7103-4df1-9ca7-13f886964abe",
"topic": "funding_source_added",
"timestamp": "2017-01-20T18:53:19.449Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/d2ca4bb9-bcec-49dc-8934-e4f086e1eba2"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/487cb8c8-7103-4df1-9ca7-13f886964abe"
}
},
"created": "2017-01-20T18:53:19.449Z"
}
Description: A funding source (Bank Account) was removed from a Dwolla account.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "f4191c1a-611b-4d3b-b006-604250c8ad9d",
"resourceId": "487cb8c8-7103-4df1-9ca7-13f886964abe",
"topic": "funding_source_removed",
"timestamp": "2017-01-20T19:00:08.022Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/f4191c1a-611b-4d3b-b006-604250c8ad9d"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/487cb8c8-7103-4df1-9ca7-13f886964abe"
}
},
"created": "2017-01-20T19:00:08.022Z"
}
Description: A funding source (Bank Account) was marked as verified.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "e27a99d5-3f3a-4c8b-afb9-276f0c8f2220",
"resourceId": "6a208a75-889f-4241-ad61-ea35d96ef7b0",
"topic": "funding_source_verified",
"timestamp": "2017-01-20T19:05:17.492Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/e27a99d5-3f3a-4c8b-afb9-276f0c8f2220"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/6a208a75-889f-4241-ad61-ea35d96ef7b0"
}
},
"created": "2017-01-20T19:05:17.492Z"
}
Description: Two <=10¢ transfers to a Dwolla account’s linked bank account were initiated.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "403b176b-cdd9-4937-b107-34a707416f88",
"resourceId": "487cb8c8-7103-4df1-9ca7-13f886964abe",
"topic": "microdeposits_added",
"timestamp": "2017-01-20T18:55:13.191Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/403b176b-cdd9-4937-b107-34a707416f88"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/487cb8c8-7103-4df1-9ca7-13f886964abe"
}
},
"created": "2017-01-20T18:55:13.191Z"
}
Description: The two <=10¢ transfers to a Dwolla account’s linked bank account failed to clear successfully.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "49da6cc7-6336-41b7-92aa-a68bebca36f5",
"resourceId": "086822ab-08ca-4fc7-8c3b-8f55b34be141",
"topic": "microdeposits_failed",
"timestamp": "2017-01-20T19:17:11.558Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/49da6cc7-6336-41b7-92aa-a68bebca36f5"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/086822ab-08ca-4fc7-8c3b-8f55b34be141"
}
},
"created": "2017-01-20T19:17:11.558Z"
}
Description: The two <=10¢ transfers to a Dwolla account’s linked bank account have cleared successfully.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "28577454-6f9b-4daf-ae0a-672be74e250b",
"resourceId": "487cb8c8-7103-4df1-9ca7-13f886964abe",
"topic": "microdeposits_completed",
"timestamp": "2017-01-20T18:58:04.920Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/28577454-6f9b-4daf-ae0a-672be74e250b"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/487cb8c8-7103-4df1-9ca7-13f886964abe"
}
},
"created": "2017-01-20T18:58:04.920Z"
}
Description: The account has reached their max verification attempts limit of three. The account can no longer verify their funding source with the completed micro-deposit amounts.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Funding
permission in order to receive this event.
{
"id": "28577454-6f9b-4daf-ae0a-672be74e250b",
"resourceId": "487cb8c8-7103-4df1-9ca7-13f886964abe",
"topic": "microdeposits_maxattempts",
"timestamp": "2017-01-20T18:58:04.920Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/28577454-6f9b-4daf-ae0a-672be74e250b"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/6238fb83-b45a-4853-90f9-0a58bf54bf32"
},
"resource": {
"href": "https://api-uat.dwolla.com/funding-sources/487cb8c8-7103-4df1-9ca7-13f886964abe"
}
},
"created": "2017-01-20T18:58:04.920Z"
}
In addition to the events included for all account types (shown above), the following events can be triggered for this particular account type.
Description: A bank transfer was created.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "397e465c-3ac7-496d-9ab5-d5f595fa7ec3",
"resourceId": "98bd3267-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_created",
"timestamp": "2017-01-20T19:26:52.146Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/397e465c-3ac7-496d-9ab5-d5f595fa7ec3"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/98bd3267-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:26:52.146Z"
}
Description: A pending bank transfer has been cancelled, and will not process further.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "84450b24-cd52-438f-80f5-80cf0111718e",
"resourceId": "afa33505-47df-e611-80ee-0aa34a9b2388",
"topic": "transfer_cancelled",
"timestamp": "2017-01-20T19:31:21.701Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/84450b24-cd52-438f-80f5-80cf0111718e"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/afa33505-47df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:31:21.701Z"
}
Description: A bank transfer failed to clear successfully to the destination party involved in the transfer.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "df107b8f-b8ed-417f-ad9d-e38ff8b40b3d",
"resourceId": "c83e604b-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_failed",
"timestamp": "2017-01-20T19:34:32.172Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/df107b8f-b8ed-417f-ad9d-e38ff8b40b3d"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/c83e604b-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:34:32.172Z"
}
Description: A bank transfer has cleared successfully to the destination party involved in the transfer.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "eaa8d342-f3b8-4d4b-bd0d-0d39c575d887",
"resourceId": "78bebf23-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_completed",
"timestamp": "2017-01-20T19:25:14.850Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/eaa8d342-f3b8-4d4b-bd0d-0d39c575d887"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/78bebf23-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:25:14.850Z"
}
In addition to the events included for all account types (shown above), the following events can be triggered for this particular account type.
Description: A transfer was created.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "397e465c-3ac7-496d-9ab5-d5f595fa7ec3",
"resourceId": "98bd3267-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_created",
"timestamp": "2017-01-20T19:26:52.146Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/397e465c-3ac7-496d-9ab5-d5f595fa7ec3"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/98bd3267-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:26:52.146Z"
}
Description: A pending transfer has been cancelled, and will not process further.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "84450b24-cd52-438f-80f5-80cf0111718e",
"resourceId": "afa33505-47df-e611-80ee-0aa34a9b2388",
"topic": "transfer_cancelled",
"timestamp": "2017-01-20T19:31:21.701Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/84450b24-cd52-438f-80f5-80cf0111718e"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/afa33505-47df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:31:21.701Z"
}
Description: A transfer failed to clear successfully to the destination within the Dwolla network.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "df107b8f-b8ed-417f-ad9d-e38ff8b40b3d",
"resourceId": "c83e604b-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_failed",
"timestamp": "2017-01-20T19:34:32.172Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/df107b8f-b8ed-417f-ad9d-e38ff8b40b3d"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/c83e604b-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:34:32.172Z"
}
Description: The transfer was returned to the sender after remaining unclaimed by the intended recipient for a period of time.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "abf59947-ee40-4011-b0da-24530319a568",
"resourceId": "98bd3267-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_reclaimed",
"timestamp": "2017-01-20T19:27:02.044Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/abf59947-ee40-4011-b0da-24530319a568"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/98bd3267-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:27:02.044Z"
}
Description: A transfer has cleared successfully to the destination within the Dwolla network.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "eaa8d342-f3b8-4d4b-bd0d-0d39c575d887",
"resourceId": "78bebf23-46df-e611-80ee-0aa34a9b2388",
"topic": "transfer_completed",
"timestamp": "2017-01-20T19:25:14.850Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/eaa8d342-f3b8-4d4b-bd0d-0d39c575d887"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/78bebf23-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:25:14.850Z"
}
Description: A transfer from a bank to the Dwolla network or to a bank from the Dwolla network was created.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "3deea7c3-28b6-40b7-b27e-19c8fc68fcb0",
"resourceId": "c73e604b-46df-e611-80ee-0aa34a9b2388",
"topic": "bank_transfer_created",
"timestamp": "2017-01-20T19:26:00.579Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/3deea7c3-28b6-40b7-b27e-19c8fc68fcb0"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/c73e604b-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:26:00.579Z"
}
Description: A transfer from a bank to the Dwolla network or to a bank from the Dwolla network was cancelled.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "bed9b838-a93b-411d-b2ca-d710051d56f0",
"resourceId": "d8802ccb-47df-e611-80ee-0aa34a9b2388",
"topic": "bank_transfer_cancelled",
"timestamp": "2017-01-20T19:36:55.485Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/bed9b838-a93b-411d-b2ca-d710051d56f0"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/d8802ccb-47df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:36:55.485Z"
}
Description: A transfer from a bank to the Dwolla network or to a bank from the Dwolla network has failed to clear successfully. Usually, this is a result of an ACH return (insufficient funds, etc.).
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "05917352-8704-4dee-8c8e-d373e449f8c3",
"resourceId": "c73e604b-46df-e611-80ee-0aa34a9b2388",
"topic": "bank_transfer_failed",
"timestamp": "2017-01-20T19:34:32.265Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/05917352-8704-4dee-8c8e-d373e449f8c3"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/c73e604b-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:34:32.265Z"
}
Description: A transfer from a bank to the Dwolla network or to a bank from the Dwolla network has cleared successfully.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Transactions
permission in order to receive this event.
{
"id": "13171980-9220-45fb-9d13-4535ab85ce4f",
"resourceId": "77bebf23-46df-e611-80ee-0aa34a9b2388",
"topic": "bank_transfer_completed",
"timestamp": "2017-01-20T19:25:16.084Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/13171980-9220-45fb-9d13-4535ab85ce4f"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/transfers/77bebf23-46df-e611-80ee-0aa34a9b2388"
}
},
"created": "2017-01-20T19:25:16.084Z"
}
Description: A mass payment was created.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Send
permission in order to receive this event.
{
"id": "09935446-6486-4aa4-a3e0-92fad507fbd5",
"resourceId": "cb587865-fa93-4c01-9f5f-a7010143ffc0",
"topic": "mass_payment_created",
"timestamp": "2017-01-20T19:39:33.717Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/09935446-6486-4aa4-a3e0-92fad507fbd5"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/mass-payments/cb587865-fa93-4c01-9f5f-a7010143ffc0"
}
},
"created": "2017-01-20T19:39:33.717Z"
}
Description: A mass payment was completed.
Note: App must have a valid refresh token for the account, and the account has granted authorization to the Send
permission in order to receive this event.
{
"id": "143e1cac-c742-4a33-84f4-5760cd7136b9",
"resourceId": "cb587865-fa93-4c01-9f5f-a7010143ffc0",
"topic": "mass_payment_completed",
"timestamp": "2017-01-20T19:39:35.830Z",
"_links": {
"self": {
"href": "https://api-uat.dwolla.com/events/143e1cac-c742-4a33-84f4-5760cd7136b9"
},
"account": {
"href": "https://api-uat.dwolla.com/accounts/380f6f7f-95c9-4e21-86d5-02986c9808df"
},
"resource": {
"href": "https://api-uat.dwolla.com/mass-payments/cb587865-fa93-4c01-9f5f-a7010143ffc0"
}
},
"created": "2017-01-20T19:39:35.830Z"
}