# How to create a mass payout via API
### **Process description**
{% stepper %}
{% step %}
Check account balance and ensure enough funds for payouts are available by using the method - [**\[POST\] account**](https://docs.calypso.finance/api-reference/account-api)
{% endstep %}
{% step %}
You can pre-calculate commissions using a special feature - [**Commission pre-calculation**](https://docs.calypso.finance/payouts/commission-pre-calculation)
{% endstep %}
{% step %}
Create the mass payouts by using the method - [**\[POST\] payout/mass/create**](https://docs.calypso.finance/api-reference/payout-api#post-api-v1-payout-mass-create)
* After creating a payout request, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: CREATION\_IN\_PROGRESS)
{% endstep %}
{% step %}
If you have payout verification enabled, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: PENDING\_CONFIRMATION)
* Once the payout is confirmed, you will receive a webhook - PAYOUT\_CONFIRMED
* If your payout was declined, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: CANCELED)
{% endstep %}
{% step %}
Once your payout request is processed, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: IN\_PROGRESS)
* If these payout are not validated before being created on the network, you will receive a webhook - PAYOUT\_VALIDATION\_ERROR
* If there are any issues with the payout and it is not processed, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: FAILED)
* If one or more payouts from the entire list fail, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: PARTIAL)
{% endstep %}
{% step %}
After a successful payment, you will receive a webhook - PAYOUT\_CHANGE\_STATUS (state: COMPLETED)
{% endstep %}
{% step %}
Get the data on the payout and its status by using the method - [**\[POST\] payout/mass**](https://docs.calypso.finance/api-reference/payout-api#post-api-v1-payout-mass)
{% endstep %}
{% endstepper %}
### Sequence
Names of requests on the scheme indicate certain payment API methods
### **Mass payout statuses**
Diagram nodes indicate mass payout statuses, arrows indicate processes a successful completion of which transfers a payout from one status to another
| ENUM value | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CREATION\_IN\_PROGRESS | Payout started creation |
| PENDING\_CONFIRMATION | A payout is created via UI and is awaiting confirmation from other process participants. |
| CONFIRMED |
• A payout is created via UI and confirmed by other process participants. • A payout created via API is automatically created with this status.
|
| CANCELED | A payout has been canceled by merchant. |
| IN\_PROGRESS |
• Transaction for a payout is created and is awaiting to be sent to the network. •Transaction for a payout is sent to the network to be sent to a block and is awaiting confirmation from nodes.
|
| FAILED |
An error occurred when sending funds. There can be many reasons of the error. You may follow these remediation steps: 1. Wait a while and create a new similar payout. 2. Contact our technical support.
|
| PARTIAL |
One or more transactions from the payout list were not completed successfully, you can get a list of unsuccessful transactions in your personal Calypso account.
