# campaigns

Endpoints for creating and managing campaigns. A campaign represents a distribution of funds to multiple beneficiaries.

 - [GET /v2/campaign-manager/campaigns](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns/get.md): Retrieves a paginated list of campaigns, optionally filtered by a payout instruction ID or a bank account ID. To include details about total funds received and statistics on the statuses of the payout
 - [POST /v2/campaign-manager/campaigns](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns/post.md): Creates a new campaign with the specified data.
 - [PATCH /v2/campaign-manager/campaigns/{id}](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D/patch.md): Patches an existing campaign with the provided data. Note: The icon needs to be patched separately.
 - [GET /v2/campaign-manager/campaigns/{id}](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D/get.md): Retrieves a single campaign based on provided identifier
 - [PATCH /v2/campaign-manager/campaigns/{id}/campaign-icon](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1campaign-icon/patch.md): Patches an existing campaign with the provided icon file.
 - [POST /v2/campaign-manager/campaigns/{id}/payout-instructions/:upload](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1payout-instructions~1:upload/post.md): Uploads a file with payout instructions to the given campaign. The maximum size of the file is 262144000 bytes
 - [GET /v2/campaign-manager/campaigns/payout-instructions/:get-sample-file](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1payout-instructions~1:get-sample-file/get.md): Retrieves a sample beneficiaries file in the expected format
 - [POST /v2/campaign-manager/campaigns/{campaignId}/payout-instructions/:send-reminders](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bcampaignid%7D~1payout-instructions~1:send-reminders/post.md): Sends reminders for a given campaign. The endpoint allows send reminders either to the specified list of IDs or to payout instructions in the specified statuses. If neither of the above is specified,
 - [POST /v2/campaign-manager/campaigns/{campaignId}/payout-instructions/:initiate](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bcampaignid%7D~1payout-instructions~1:initiate/post.md): Initiates payout instructions from given campaign.
 - [POST /v2/campaign-manager/campaigns/{campaignId}/:set-password](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bcampaignid%7D~1:set-password/post.md): Allows to set a password for the campaign. From that moment on, each beneficiary will be asked to enter the password when attempting to redeem funds. Once set, the password cannot be removed, it can o
 - [GET /v2/campaign-manager/campaigns/{id}/account-details](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1account-details/get.md): Retrieves a single bank account based on provided campaign identifier
 - [GET /v2/campaign-manager/campaigns/{id}/withdrawal-accounts](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1withdrawal-accounts/get.md): Retrieves a list of return external accounts for particular campaign
 - [POST /v2/campaign-manager/campaigns/{id}/withdrawal-accounts](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1withdrawal-accounts/post.md): Creates a new withdrawal account associated with a bank account
 - [GET /v2/campaign-manager/campaigns/{id}/transactions](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bid%7D~1transactions/get.md): Retrieves a list of transactions tagged with the specific campaign. When 'aggregate' is set to true, InternalTransfer transactions are aggregated by UTC date and status, while other transaction types
 - [POST /v2/campaign-manager/campaigns/{campaignId}/:refund](https://docs.talli.ai/reference/swagger/campaigns/paths/~1v2~1campaign-manager~1campaigns~1%7Bcampaignid%7D~1:refund/post.md): Triggers a money movement from a campaign bank account to return external account.