> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dwolla.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> List or retrieve an event using the Dwolla API.
# Events
When the state of a resource changes, Dwolla creates a new event resource to record the change. When an Event is created, a Webhook will be created to deliver the Event to any URLs specified by your active [Webhook Subscriptions](/docs/api-reference/webhook-subscriptions). To view example payloads for Customer related events, refer to the [Webhooks Events](/docs/webhook-events) resource within the Developer Docs.
### Events resource
| Parameter | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \_links | Contains links to the event, associated resource, and the Account associated with the event. |
| id | Event ID |
| created | ISO-8601 timestamp when event was created |
| topic | Type of event |
| resourceId | ID of the resource associated with the event. |
| correlationId | Unique ID that was specified, if any, when a [transfer was created](/docs/api-reference/transfers/initiate-a-transfer).
**This value is only present for [Account transfer](#transfers) and [Customer transfer](#transfers-1) events.** |
```bash theme={"dark"}
{
"_links": {
"self": {
"href": "https://api.dwolla.com/events/f8e70f48-b7ff-47d0-9d3d-62a099363a76"
},
"resource": {
"href": "https://api.dwolla.com/transfers/48CFDDB4-1E74-E511-80DB-0AA34A9B2388"
},
"account": {
"href": "https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b"
}
},
"id": "f8e70f48-b7ff-47d0-9d3d-62a099363a76",
"created": "2015-10-16T15:58:15.000Z",
"topic": "transfer_created",
"resourceId": "48CFDDB4-1E74-E511-80DB-0AA34A9B2388"
}
```
## Dwolla Master Account Event topics
### Accounts
| Topic | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------- |
| account\_suspended | **Description**: A Dwolla Master Account was suspended. |
| account\_activated | **Description**: A Dwolla Master Account moves from deactivated or suspended to active state of verification. |
### Funding Sources
| Topic | Description |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| funding\_source\_added | **Description**: A funding source was added to a Dwolla account.
**Timing**: Occurs after a bank funding source is created for the Master account. |
| funding\_source\_removed | **Description**: A funding source was removed from a Dwolla account.
**Timing**: Occurs upon a POST request to the [Remove a funding source](/docs/api-reference/funding-sources/update-or-remove-a-funding-source) endpoint, or when Dwolla systematically removes a funding source upon receiving certain ACH return codes when a transfer fails. |
| funding\_source\_verified | **Description**: A funding source was marked as `verified`.
**Timing**: Occurs when the Master Account Admin Verifies their funding source through micro-deposits. |
| funding\_source\_unverified | **Description**: A funding source has been systematically `unverified`. This is generally a result of a transfer failure. [View our developer resource article](/docs/transfer-failures) to learn more. |
| funding\_source\_negative | **Description**: A Dwolla Master Account `balance` has gone negative. You are responsible for ensuring a zero or positive Dwolla balance for your account. If your balance funding source has gone negative, you are responsible for making the Dwolla account whole. Dwolla will notify you via a webhook and separate email of the negative balance. If no action is taken, Dwolla will debit your attached billing source.
**Timing**: Occurs immediately after a Master account balance becomes negative. |
| funding\_source\_updated | **Description**: A funding source has been updated. This can also be fired as a result of a correction after a bank transfer process. For example, a financial institution can issue a correction to change the bank account `type` from `checking` to `savings`.
**Timing**: Occurs after the Master Account Admin or the bank makes a correction to the funding source. |
| microdeposits\_added | **Description**: Two `<=10¢` transfers to a Dwolla Master Account's linked bank account were initiated.
**Timing**: Occurs when Dwolla processes micro-deposits to the linked bank account. |
| microdeposits\_failed | **Description**: The two `<=10¢` transfers to a Dwolla Master Account's linked bank account failed to clear successfully.
**Timing**: Occurs when the microdeposits are returned by the bank or if the destination bank is removed before the micro-deposits export out of Dwolla. |
| microdeposits\_completed | **Description**: The two `<=10¢` transfers to a Dwolla Master Account's linked bank account have cleared successfully.
**Timing**: Occurs when micro-deposits are successfully verified. |
| microdeposits\_maxattempts | **Description**: The funding source has reached its max verification attempts limit of three. The funding source can no longer be verified with the completed micro-deposit amounts.
**Timing**: Occurs with the fourth attempt to verify micro-deposits. |
### Transfers
For [Account](/docs/api-reference/accounts) transfer events, in addition to the [default payload keys](#events-resource), a `correlationId` key-value pair *may* be present if a value was specified when the [transfer was created](/docs/api-reference/transfers/initiate-a-transfer).
| Topic | Description |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| bank\_transfer\_created | **Description**: A bank transfer was created. Represents funds moving either from a Dwolla Master Account's bank to the Dwolla network or from the Dwolla network to a Dwolla Master Account's bank.
**Timing**: Occurs upon a POST request to the [Initiate a transfer](/docs/api-reference/transfers/initiate-a-transfer) endpoint when sending funds from a Dwolla Master Account's bank, or when funds move from the Dwolla Master Account's balance to their bank. |
| bank\_transfer\_creation\_failed | **Description**: An attempt to initiate a transfer to a Master Account's bank was made, but failed. Transfers initiated to a Master Account's bank must pass through the Master Account's balance before being sent to a receiving bank. Dwolla will fail to create a transaction intended for a Master Account's bank if the funds available in the balance are less than the transfer amount.
**Timing**: Occurs when a transfer to a Dwolla Master Account's bank fails to be created. |
| bank\_transfer\_cancelled | **Description**: A pending bank transfer has been cancelled, and will not proceed further. Represents a cancellation of funds either transferring from a Dwolla Master Account's bank to the Dwolla network or from the Dwolla network to a Dwolla Master Account's bank.
**Timing**: Occurs upon a POST request to the [Cancel a Transfer](/docs/api-reference/transfers/cancel-a-transfer) endpoint, or when Dwolla manually cancels a transfer. |
| bank\_transfer\_failed | **Description**: A transfer failed to clear successfully. Usually, this is a result of an ACH failure (insufficient funds, etc.). Represents funds failing to clear either from a Dwolla Master Account's bank to the Dwolla network or from the Dwolla network to a Dwolla Master Account's bank.
**Timing**: Occurs when a Dwolla Master Account's bank issues an ACH failure on an incoming or outgoing transfer. |
| bank\_transfer\_completed | **Description**: A bank transfer has cleared successfully. Represents funds clearing either from a Dwolla Master Account's bank to the Dwolla network or from the Dwolla network to a Dwolla Master Account's bank.
**Timing**: Occurs when Dwolla has processed a transfer to or from a Dwolla Master Account's bank. |
| transfer\_created | **Description**: A transfer was created. Represents funds moving either to or from a Dwolla Master Account's `balance` or `bank`.
**Timing**: Occurs upon a POST request to the [Initiate a transfer](/docs/api-reference/transfers/initiate-a-transfer) endpoint when sending funds from a Dwolla Master Account's `bank` or `balance`. |
| transfer\_cancelled | **Description**: A pending transfer has been cancelled, and will not proceed further. Represents a cancellation of funds transferring either to or from a Dwolla Master Account's `balance` or `bank`.
**Timing**: Occurs upon a POST request to the [Cancel a transfer](/docs/api-reference/transfers/cancel-a-transfer) endpoint, or when a transfer is systemically canceled by Dwolla in the event that the funding source is removed after the initiation of the transfer and before it exports out of Dwolla |
| transfer\_failed | **Description**: A transfer failed to clear successfully. Represents funds failing to clear either to or from a Dwolla Master Account's `balance` or `bank`.
**Timing**: Occurs after Dwolla receives an ACH return from the bank. |
| transfer\_completed | **Description**: A transfer has cleared successfully. Represents funds clearing either to or from a Dwolla Master Account's `balance` or `bank`.
**Timing**: Occurs after the transfer has successfully been processed in or out of the Dwolla Master Account's balance or bank based on the transfer processing timing used. |
### Mass Payments
| Topic | Description |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| mass\_payment\_created | **Description**: A mass payment was created.
**Timing**: Occurs upon a POST request to the [Initiate a mass-payment](/docs/api-reference/mass-payments/initiate-a-mass-payment) endpoint. |
| mass\_payment\_completed | **Description**: A mass payment was completed. However, this doesn't mean that each mass payment item's transfer was successful.
**Timing**: Occurs when a mass payment job completes. |
| mass\_payment\_cancelled | **Description**: A created and deferred mass payment was cancelled.
**Timing**: Occurs upon a POST request to the [Update a mass-payment](/docs/api-reference/mass-payments/update-a-mass-payment) endpoint when cancelling a mass payment job. |
### Statements
| Topic | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| statement\_created | **Description**: A monthly balance summary and a detailed transaction record for the previous month was created for a Dwolla Master Account.
**Timing**: Occurs at the beginning of each month. |
## Customer Account Event topics
### Customers
| Topic | Description |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_created | **Description**: A Customer was created.
**Timing**: Occurs upon a POST request to the [Create a Customer](/docs/api-reference/customers/create-a-customer) endpoint. |
| customer\_kba\_verification\_needed | **Description**: The retry identity verification attempt failed due insufficient scores on the submitted data. The end user will have a single kba attempt to answer a set of "out of wallet" questions about themselves for identity verification.
**Timing**: Occurs after a failed attempt to verify a Verified Customer Record. |
| customer\_kba\_verification\_failed | **Description**: The end user failed KBA verification and was unable to correctly answer at least three KBA questions.
**Timing**: Triggered after a single attempt at verifying a Verified Customer Record using KBA. |
| customer\_kba\_verification\_passed | **Description**: The end user was able to correctly answer at least three KBA questions.
**Timing**: Triggered after a Verified Customer Record successfully passes KBA requirements. |
| customer\_verification\_document\_needed | **Description**: Additional documentation is needed to verify a Customer.
**Timing**: Occurs when a second attempt to re-verify a Customer fails, which systematically places the Customer in document status immediately after a POST request to the [Update a Customer](/docs/api-reference/customers/update-a-customer) endpoint. |
| customer\_verification\_document\_uploaded | **Description**: A verification document was uploaded for a Customer.
**Timing**: Occurs upon a POST request to the [Create a Document](/docs/api-reference/#create-a-document-for-a-customer) endpoint. |
| customer\_verification\_document\_failed | **Description**: A verification document has been rejected for a Customer.
**Timing**: Occurs when a document uploaded for a Customer is reviewed by Dwolla, and rejected with a document failure reason, usually within 1-2 business days of uploading a document. |
| customer\_verification\_document\_approved | **Description**: A verification document was approved for a Customer.
**Timing**: Occurs when a document uploaded for a Customer is reviewed by Dwolla, and approved, usually within 1-2 business days of uploading a document. |
| customer\_reverification\_needed | **Description**: Incomplete information was received for a Customer; updated information is needed to verify the Customer.
**Timing**: Occurs upon a POST request to the [Update a Customer](/docs/api-reference/customers/update-a-customer) endpoint, or when Dwolla places a Customer into retry status. |
| customer\_verification\_pending\_review | **Description**: Sent when a Customer enters manual review (AdditionalReviewRequired). No further action is required until Dwolla completes review. This webhook could accompany the customer\_suspended webhook.
**Timing**: Occurs when Dwolla places a Customer into suspended status for manual review; can be triggered on the initial verification attempt, retry attempts, and/or manually. |
| customer\_address\_verification\_failed | **Description**: Sent when verification returns an address-related directive (POBoxNotAllowed, AddressNotAssociatedWithBusiness, ResidentialAddressRequired, CoWorkingAddress, or RegisteredAgentAddressNotAllowed). The address needs to be updated and/or proof of address documentation is required. This webhook could accompany the customer\_reverification\_needed webhook or be sent after a document is uploaded while in the document status.
**Timing**: Occurs on the initial verification attempt, during retry attempts, after document review, and/or manually. |
| customer\_verified | **Description**: A Customer was verified.
**Timing**: Occurs when a Customer is verified by Dwolla upon a POST request to the [Create a Customer endpoint](/docs/api-reference/customers/create-a-customer). In a case where the Customer isn't instantly verified upon creation, this event occurs when the Customer is verified after a retry attempt, or after a document is approved. |
| customer\_suspended | **Description**: A Customer was suspended.
**Timing**: Occurs when Dwolla systematically places a Customer in suspended status as a result of uploading fraudulent documents, or upon receiving certain ACH return codes when a transfer fails. |
| customer\_activated | **Description**: A Customer moves from deactivated or suspended to an active status.
**Timing**: Occurs upon reactivating a Customer that has a deactivated status by making a POST request to the [Update a Customer](/docs/api-reference/customers/update-a-customer) endpoint, or when Dwolla reactivates a Customer that has a suspended status. |
| customer\_deactivated | **Description**: A Customer was deactivated.
**Timing**: Occurs upon deactivation of a Customer by making a POST request to the [Update a Customer](/docs/api-reference/customers/update-a-customer) endpoint, or when Dwolla systematically deactivates a Customer upon receiving certain ACH return codes when a transfer fails. |
### Beneficial Owners
| Topic | Description |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_beneficial\_owner\_created | **Description**: Beneficial owner successfully created.
**Timing**: Occurs upon a POST request to the [Create a beneficial owner](/docs/api-reference/beneficial-owners/create-beneficial-owner) endpoint. |
| customer\_beneficial\_owner\_removed | **Description**: An individual beneficial owner has been successfully removed from the Customer.
**Timing**: Occurs upon a POST request to the [Remove a beneficial owner](/docs/api-reference/beneficial-owners/delete-beneficial-owner) endpoint. |
| customer\_beneficial\_owner\_verification\_document\_needed | **Description**: Additional documentation is needed to verify an individual beneficial owner.
**Timing**: Occurs when a second attempt to re-verify a beneficial owner fails, which systematically places the beneficial owner in document status immediately after a POST request to the [Update a beneficial owner](/docs/api-reference/beneficial-owners/update-beneficial-owner) endpoint. |
| customer\_beneficial\_owner\_verification\_document\_uploaded | **Description**: A verification document was uploaded for the beneficial owner.
**Timing**: Occurs upon a POST request to the [Create a document for a beneficial owner](/docs/api-reference/documents/create-a-document-for-beneficial-owner) endpoint. |
| customer\_beneficial\_owner\_verification\_document\_failed | **Description**: A verification document has been rejected for a beneficial owner.
**Timing**: Occurs when a document uploaded for a beneficial owner is reviewed by Dwolla, and rejected with a document failure reason, usually within 1-2 business of uploading a document. |
| customer\_beneficial\_owner\_verification\_document\_approved | **Description**: A verification document was approved for a beneficial owner.
**Timing**: Occurs when a document uploaded for a Customer is reviewed by Dwolla, and approved, usually within 1-2 business days of uploading a document. |
| customer\_beneficial\_owner\_reverification\_needed | **Description**: A previously `verified` beneficial owner status has changed due to either a change in the beneficial owner's information or at request for more information from Dwolla. The individual will need to verify their identity within 30 days.
**Timing**: Occurs upon a POST request to the [Update a beneficial owner](/docs/api-reference/beneficial-owners/update-beneficial-owner) endpoint, or when Dwolla places the beneficial owner into incomplete status. |
| customer\_beneficial\_owner\_verified | **Description**: A beneficial owner has been verified.
**Timing**: Occurs when a Beneficial Owner is verified by Dwolla upon a POST request to the [Create a beneficial owner](/docs/api-reference/beneficial-owners/create-beneficial-owner) endpoint. In a case where the Beneficial Owner isn't instantly verified upon creation, this event occurs when the Beneficial Owner is verified after an update, or after a document is approved. |
### Exchanges
| Event Topic Name | Description |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_exchange\_reauth\_required | **Description:** An exchange has been deactivated (or is pending deactivation) and requires reauthentication.
**Timing:** Occurs when access to a user's connected bank account has been interrupted. This interruption could be due to changes on the bank's end, such as a password update, multi-factor authentication reset or revoked consent. This event signals that a user's bank connection needs to be refreshed by [creating a reauth exchange session](/docs/api-reference/exchange-sessions/create-re-authentication-exchange-session). |
### Funding Sources
| Topic | Description |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_funding\_source\_added | **Description**: A funding source was added to a Customer.
**Timing**: Occurs upon a POST request to the [Create a funding source for a customer](/docs/api-reference/funding-sources/create-customer-funding-source) endpoint, or when a funding source is added via [drop-in components](/docs/bank-funding-source#drop-in-components) or a third party bank verification method. |
| customer\_funding\_source\_removed | **Description**: A funding source was removed from a Customer.
**Timing**: Occurs upon a POST request to the [Remove a funding source](/docs/api-reference/funding-sources/update-or-remove-a-funding-source) endpoint, or when Dwolla systematically removes a funding source upon receiving certain ACH return codes when a transfer fails. |
| customer\_funding\_source\_verified | **Description**: A Customer's funding source was marked as verified.
**Timing**: Occurs upon a POST request to the [Verify micro-deposits](/docs/api-reference/funding-sources/initiate-or-verify-micro-deposits) endpoint with the correct amounts, or when a funding source is added + verified via a third-party bank verification method. Also occurs in cases where Dwolla manually marks a funding source as verified. |
| customer\_funding\_source\_unverified | **Description**: A funding source has been systematically `unverified`. This is generally a result of a transfer failure. [View our developer resource article](https://developers.dwolla.com/concepts/transfer-failures) to learn more.
**Timing**: Occurs when Dwolla systematically marks a funding source unverified upon receiving certain ACH return codes when a transfer fails. |
| customer\_funding\_source\_negative | **Description**: A Customer's `balance` has gone negative. You are responsible for ensuring a zero or positive Dwolla balance for Customer accounts created by your application. If a Customer balance funding source has gone negative, you are responsible for making the Dwolla Customer account whole. Dwolla will notify you via a webhook and separate email of the negative balance. If no action is taken, Dwolla will debit your attached billing source.
**Timing**: Occurs upon a POST request to the [Initiate a transfer](/docs/api-reference/transfers/initiate-a-transfer) endpoint that causes a funding source balance to go negative. |
| customer\_funding\_source\_updated | **Description**: A Customer's funding source has been updated. This can also be fired as a result of a correction after a bank transfer process. For example, a financial institution can issue a correction to change the bank account `type` from `checking` to `savings`.
**Timing**: Occurs upon a POST request to the [Update a funding source](/docs/api-reference/funding-sources/update-or-remove-a-funding-source) endpoint. |
| customer\_microdeposits\_added | **Description**: Two `<=10¢` transfers to a Customer's linked bank account were initiated.
**Timing**: Occurs upon a POST request to the Initiate micro-deposits endpoint. |
| customer\_microdeposits\_failed | **Description**: The two `<=10¢` transfers to a Customer's linked bank account failed to clear successfully.
**Timing**: Occurs when micro-deposits fail to clear into a bank account, usually within 1-2 business days of initiating them. |
| customer\_microdeposits\_completed | **Description**: The two `<=10¢` transfers to a Customer's linked bank account have cleared successfully.
**Timing**: Occurs when micro-deposit are successful, usually within 1-2 business days of initiating them. |
| customer\_microdeposits\_maxattempts | **Description**: The Customer has reached their max verification attempts limit of three. The Customer can no longer verify their funding source with the completed micro-deposit amounts.
**Timing**: Occurs upon the third POST request to the [Verify micro-deposits](/docs/api-reference/funding-sources/initiate-or-verify-micro-deposits) endpoint with incorrect micro-deposit amounts. |
### Transfers
For [Customer](/docs/api-reference/customers) transfer events, in addition to the [default payload keys](#events-resource), a `correlationId` key-value pair *may* be present if a value was specified when the [transfer was created](/docs/api-reference/transfers/initiate-a-transfer).
| Topic | Description |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| customer\_bank\_transfer\_created | **Description**: A bank transfer was created for a Customer. Represents funds moving either from a verified Customer's `bank` to the Dwolla network or from the Dwolla network to a verified Customer's `bank`.
**Timing**: Occurs upon a POST request to the [Initiate a transfer](/docs/api-reference/transfers/initiate-a-transfer) endpoint when sending funds from a Verified Customer's bank, or when funds move from a receiving Verified Customer's balance to their bank. |
| customer\_bank\_transfer\_creation\_failed | **Description**: An attempt to initiate a transfer to a verified Customer's `bank` was made, but failed. Transfers initiated to a verified Customer's `bank` must pass through the verified Customer's `balance` before being sent to a receiving bank. Dwolla will fail to create a transaction intended for a verified Customer's `bank` if the funds available in the `balance` are less than the transfer amount.
**Timing**: Occurs when a transfer to a verified Customer's bank fails to be created. |
| customer\_bank\_transfer\_cancelled | **Description**: A pending Customer bank transfer has been cancelled, and will not proceed further. Represents a cancellation of funds either transferring from a verified Customer's `bank` to the Dwolla network or from the Dwolla network to a verified Customer's `bank`.
**Timing**: Occurs upon a POST request to the [Cancel a transfer](/docs/api-reference/transfers/cancel-a-transfer) endpoint, or when Dwolla manually cancels a transfer. |
| customer\_bank\_transfer\_failed | **Description**: A Customer bank transfer failed to clear successfully. Usually, this is a result of an ACH failure (insufficient funds, etc.). Represents funds failing to clear either from a verified Customer's `bank` to the Dwolla network or from the Dwolla network to a verified Customer's `bank`.
**Timing**: Occurs when Dwolla marks a transfer as failed. |
| customer\_bank\_transfer\_completed | **Description**: A bank transfer that was created for a Customer has cleared successfully. Represents funds clearing either from a verified Customer's `bank` to the Dwolla network or from the Dwolla network to a verified Customer's `bank`.
**Timing**: Occurs when a funds transfer into the Dwolla Platform or a verified Customer's bank is successful, based on the transfer processing timing used. |
| customer\_transfer\_created | **Description**: A transfer was created for a Customer. Represents funds transferring to an unverified Customer's `bank` or to a verified Customer's `balance`.
**Timing**: Occurs upon a POST request to the [Initiate a transfer](/docs/api-reference/transfers/initiate-a-transfer) endpoint when sending funds from a verified Customer's balance, or to/from an unverified Customer's bank. |
| customer\_transfer\_cancelled | **Description**: A pending transfer has been cancelled, and will not process further. Represents a cancellation of funds transferring either to an unverified Customer's `bank` or to a verified Customer's `balance`.
**Timing**: Occurs upon a POST request to the [Cancel a transfer](/docs/api-reference/transfers/cancel-a-transfer) endpoint to cancel a transfer initiated from a verified Customer's balance, or to/from an unverified Customer's bank. |
| customer\_transfer\_failed | **Description**: A Customer transfer failed to clear successfully. Represents funds failing to clear either to an unverified Customer's `bank` or to a verified Customer's `balance`.
**Timing**: Occurs when Dwolla marks a transfer as failed. |
| customer\_transfer\_completed | **Description**: A Customer transfer has cleared successfully. Represents funds clearing either to an unverified Customer's `bank` or to a verified Customer's `balance`.
**Timing**: Occurs when a funds transfer into an unverified Customer's bank or a verified Customer's balance is successful, based on the transfer processing timing used. |
### Mass Payments
| Topic | Description |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_mass\_payment\_created | **Description**: A Verified Customer's mass payment was created.
**Timing**: Occurs upon a POST request to the [Update a mass-payment](/docs/api-reference/mass-payments/update-a-mass-payment) endpoint when cancelling a mass payment job. |
| customer\_mass\_payment\_completed | **Description**: A Verified Customer's mass payment was completed. However, this doesn't mean that each mass payment item's transfer was successful.
**Timing**: Occurs when a mass payment job completes. |
| customer\_mass\_payment\_cancelled | **Description**: A Verified Customer's created and deferred mass payment was cancelled.
**Timing**: Occurs upon a POST request to the [Update a mass-payment](/docs/api-reference/mass-payments/update-a-mass-payment) endpoint when cancelling a mass payment job. |
| customer\_balance\_inquiry\_completed | **Description**: Upon checking a Customer's bank balance, Dwolla will immediately return an HTTP 202 with response body that includes a status of `processing`.
**Timing**: This event will be triggered when the bank balance check has completed processing. |
### Labels
| Topic | Description |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_label\_created | **Description**: A Verified Customer's label was created.
**Timing**: Occurs upon a POST request to the [Create a label](/docs/api-reference/labels/create-a-label-for-a-customer) endpoint. |
| customer\_label\_ledger\_entry\_created | **Description**: A ledger entry for a Verified Customer's label was created.
**Timing**: Occurs upon a POST request to the [Create a label ledger entry](/docs/api-reference/labels/create-a-label-for-a-customer) endpoint. |
| customer\_label\_removed | **Description**: A Verified Customer's label was removed.
**Timing**: Occurs upon a POST request to the [Remove a label](/docs/api-reference/labels/remove-a-label) endpoint. |