--- updatedAt: 2026-06-25T22:44:00.000Z --- Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further. # Create bulk transfer schedules Create multiple transfer schedules in a single request. This request triggers an asynchronous process to create the schedules. Once processing is complete, the [Bulk transfer schedules created](https://developers.pismo.io/events/docs/scheduler-payments-bulk-transfer-scheduled-payments-1) event is sent with the result of the operation. This endpoint accepts a `defaults` object that can be used to set common values for all schedules in the request. Individual schedules can override any default value by specifying the field in their own definition. Transfer amounts can be set as follows. - If you fill out the `strategy` field, the platform uses the strategy logic to determine transfer amounts. - If you don't fill out the `strategy` field, you must specify the `amount` field for each transfer in the `transfers` array, or provide a default amount in `transfer_defaults`. In some cases, due to errors and retries, execution of the scheduled transaction might occur on the following day instead of the originally scheduled date. To address this, the `allow_execution_after_day_change` flag in `schedule_details` enables you to pre-authorize execution of the scheduled transaction on the next day. This flag must be set to `true` for schedules that are set to be executed at the end of the day (after 11:30pm UTC). If the schedule is not executed on the expected day for any reason, and this field isn't set to `true`, the schedule is not executed and is marked as `EXECUTED_WITH_ERROR_NEXT_DAY_NOT_ALLOWED`. This endpoint generates the [Scheduled payment created or modified](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-1) event with the `status` field set to `CREATED`. Each execution of the schedule also generates the [Scheduled payment executed](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-execution-1) event. Refer to the [Payment scheduler](doc:payment-scheduler) guide for more information. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Core platform - Payment scheduler", "version": "1.0.0", "description": "Endpoints to enable scheduler creation and processing.", "contact": { "name": "API Support", "url": "https://developers.pismo.io/" }, "license": { "name": "Copyright Pismo" } }, "servers": [ { "url": "https://sandbox.pismolabs.io/scheduler-payments", "description": "Sandbox API server for testing" } ], "tags": [ { "name": "Schedules", "description": "Endpoints to enable scheduler creation and processing" } ], "components": { "responses": { "400BadRequest": { "description": "Bad request" }, "403Forbidden": { "description": "Operation forbidden" }, "500InternalServer": { "description": "Internal server error" } }, "schemas": { "AccountID": { "description": "Account ID", "type": "integer", "format": "int64", "example": 8675309 }, "AllowExecutionAfterDayChange": { "type": "boolean", "description": "Can the schedule be executed after the day changes? For single and transfer schedules that are scheduled for after 11:30pm UTC, this field is required to be `true`.", "example": false, "default": false }, "Amount": { "type": "number", "format": "float", "description": "Credit or debit amount", "example": 100.23 }, "DayType": { "type": "string", "description": "`BUSINESS_DAY` type ignores weekends and holidays, `CALENDAR_DAY` includes all calendar days.", "enum": [ "BUSINESS_DAY", "CALENDAR_DAY" ], "example": "CALENDAR_DAY" }, "Description": { "type": "string", "description": "Optional text that describes the operation", "example": "Custom purchase", "maxLength": 100 }, "EndDate": { "type": "string", "format": "date-time", "description": "End date of schedule executions in the UTC-0 RFC3339 format. Format: YYYY-MM-DDTHH:mm:ss.sssZ.\n", "example": "2023-01-02T07:00:00.000Z" }, "Interval": { "type": "string", "description": "Schedule execution frequency", "enum": [ "DAILY", "WEEKLY", "MONTHLY", "YEARLY" ], "example": "DAILY" }, "Metadata": { "type": "object", "description": "This optional user-defined key-value object field can be used with external operations to provide additional context or supplementary custom information for the operation. The Pismo platform does not perform any validation or processing on this field.\n\n**Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).\n", "example": { "any-key": "any-value" } }, "BulkTransferScheduleRequest": { "type": "object", "description": "Request to create multiple transfer schedules in bulk", "required": [ "schedules" ], "properties": { "defaults": { "$ref": "#/components/schemas/BulkTransferScheduleDefaults" }, "schedules": { "type": "array", "description": "List of transfer schedules to create. Each schedule can override any default value.", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/BulkTransferScheduleItem" } } } }, "BulkTransferScheduleDefaults": { "type": "object", "description": "Default values applied to all transfer schedules in the request. Individual schedules can override these values.", "properties": { "description": { "$ref": "#/components/schemas/Description" }, "schedule_details": { "$ref": "#/components/schemas/BulkTransferScheduleDetailsDefault" }, "strategy": { "$ref": "#/components/schemas/Strategy" }, "transfer_defaults": { "$ref": "#/components/schemas/BulkTransferDefaults" } } }, "BulkTransferScheduleDetailsDefault": { "type": "object", "description": "Default schedule details that can be applied to all transfer schedules", "properties": { "type": { "$ref": "#/components/schemas/Type" }, "interval": { "$ref": "#/components/schemas/Interval" }, "day_type": { "$ref": "#/components/schemas/DayType" }, "start_date": { "$ref": "#/components/schemas/StartDateTime" }, "end_date": { "$ref": "#/components/schemas/EndDate" }, "allow_execution_after_day_change": { "$ref": "#/components/schemas/AllowExecutionAfterDayChange" } } }, "BulkTransferDefaults": { "type": "object", "description": "Default values for individual transfers within schedules", "properties": { "amount": { "$ref": "#/components/schemas/Amount" }, "description": { "$ref": "#/components/schemas/Description" }, "from_processing_code": { "$ref": "#/components/schemas/ProcessingCode" }, "to_processing_code": { "$ref": "#/components/schemas/ProcessingCode" }, "metadata": { "$ref": "#/components/schemas/Metadata" } } }, "BulkTransferScheduleItem": { "type": "object", "description": "Individual transfer schedule in the bulk request. Only `schedule_id` and `transfers` are required; other fields use defaults or override them.", "required": [ "schedule_id", "transfers" ], "properties": { "schedule_id": { "$ref": "#/components/schemas/ScheduleID" }, "description": { "$ref": "#/components/schemas/Description" }, "schedule_details": { "$ref": "#/components/schemas/BulkTransferScheduleDetailsOverride" }, "strategy": { "$ref": "#/components/schemas/Strategy" }, "transfers": { "type": "array", "description": "List of transfers for this schedule. At least one transfer is required.", "minItems": 1, "items": { "$ref": "#/components/schemas/BulkTransferItemRequest" } } } }, "BulkTransferScheduleDetailsOverride": { "type": "object", "description": "Schedule details that override the defaults for this specific transfer schedule", "properties": { "type": { "$ref": "#/components/schemas/Type" }, "interval": { "$ref": "#/components/schemas/Interval" }, "day_type": { "$ref": "#/components/schemas/DayType" }, "start_date": { "$ref": "#/components/schemas/StartDateTime" }, "end_date": { "$ref": "#/components/schemas/EndDate" }, "allow_execution_after_day_change": { "$ref": "#/components/schemas/AllowExecutionAfterDayChange" } } }, "BulkTransferItemRequest": { "type": "object", "description": "Individual transfer within a schedule. Account IDs in the `from` and `to` fields are required; other fields can use defaults.", "required": [ "from", "to" ], "properties": { "amount": { "$ref": "#/components/schemas/Amount" }, "description": { "$ref": "#/components/schemas/Description" }, "from": { "$ref": "#/components/schemas/BulkTransferFrom" }, "to": { "$ref": "#/components/schemas/BulkTransferTo" }, "metadata": { "$ref": "#/components/schemas/Metadata" } } }, "BulkTransferFrom": { "type": "object", "description": "Source of a transfer. `account_id` is required; `processing_code` can use the default value.", "required": [ "account_id" ], "properties": { "account_id": { "$ref": "#/components/schemas/AccountID" }, "processing_code": { "$ref": "#/components/schemas/ProcessingCode" } } }, "BulkTransferTo": { "type": "object", "description": "Destination of a transfer. `account_id` is required; `processing_code` can use the default value.", "required": [ "account_id" ], "properties": { "account_id": { "$ref": "#/components/schemas/AccountID" }, "processing_code": { "$ref": "#/components/schemas/ProcessingCode" } } }, "ProcessingCode": { "type": "string", "description": "Processing code that identifies the credit or debit operation", "example": "219803" }, "ScheduleID": { "type": "string", "description": "Schedule ID (idempotency field for this operation)", "minLength": 36, "maxLength": 50, "example": "eec3df75-629d-43dc-8eb7-e3b186188341" }, "StartDateTime": { "type": "string", "format": "date-time", "description": "Start date of executions in the UTC-0 RFC3339 format. Format: YYYY-MM-DDTHH:mm:ss.sssZ.\n", "example": "2023-01-02T07:00:00.000Z" }, "Strategy": { "type": "string", "description": "If the `strategy` field is not specified, you must provide the `amount` field for each transfer in the `transfers` array. The following strategy types determine the transfer amounts when a strategy is specified.\n\n- `SWEEP`: Transfers the entire balance from the child account to the parent account. The terms \"parent\" and \"child\" refer to account roles, but no relationship validation is performed.\n\n Child → Parent\n\n- `OVERDRAFT_SWEEEP`: Follows the same logic as `SWEEP`, except when a child account is negative, in which case the main account sends enough money to zero out the child account.\n\n Parent → Child\n", "enum": [ "OVERDRAFT_SWEEP", "SWEEP" ], "example": "SWEEP" }, "Type": { "type": "string", "description": "Should a schedule be executed once or in a recurring fashion?\n- `ONCE`: Executed only once on the date specified in `start_date`.\n- `RECURRING`: Executed repeatedly according to the interval defined in `interval`, within the period between `start_date` and `end_date`. A recurring schedule can run daily, weekly, monthly, or yearly, which is set in the `interval` field.\n", "enum": [ "ONCE", "RECURRING" ], "example": "RECURRING" } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Account access token. Tokens can expire quickly, which can result in an \"Unauthorized\" error.", "bearerFormat": "JWT" } } }, "security": [ { "BearerAuth": [] } ], "paths": { "/v1/transfers/bulk": { "post": { "summary": "Create bulk transfer schedules", "operationId": "post-v1-create-bulk-transfer-schedules", "description": "Create multiple transfer schedules in a single request. This request triggers an asynchronous process to create the schedules. Once processing is complete, the [Bulk transfer schedules created](https://developers.pismo.io/events/docs/scheduler-payments-bulk-transfer-scheduled-payments-1) event is sent with the result of the operation.\n\nThis endpoint accepts a `defaults` object that can be used to set common values for all schedules in the request. Individual schedules can override any default value by specifying the field in their own definition.\n\nTransfer amounts can be set as follows.\n- If you fill out the `strategy` field, the platform uses the strategy logic to determine transfer amounts.\n- If you don't fill out the `strategy` field, you must specify the `amount` field for each transfer in the `transfers` array, or provide a default amount in `transfer_defaults`.\n\nIn some cases, due to errors and retries, execution of the scheduled transaction might occur on the following day instead of the originally scheduled date. To address this, the `allow_execution_after_day_change` flag in `schedule_details` enables you to pre-authorize execution of the scheduled transaction on the next day. This flag must be set to `true` for schedules that are set to be executed at the end of the day (after 11:30pm UTC). If the schedule is not executed on the expected day for any reason, and this field isn't set to `true`, the schedule is not executed and is marked as `EXECUTED_WITH_ERROR_NEXT_DAY_NOT_ALLOWED`.\n\nThis endpoint generates the [Scheduled payment created or modified](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-1) event with the `status` field set to `CREATED`.\n\nEach execution of the schedule also generates the [Scheduled payment executed](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-execution-1) event.\n\nRefer to the [Payment scheduler](https://developers.pismo.io/pismo-docs/docs/payment-scheduler) guide for more information.\n", "tags": [ "Schedules" ], "requestBody": { "description": "Request processing body", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkTransferScheduleRequest" } } } }, "responses": { "202": { "description": "Request was accepted and schedules will be processed asynchronously." }, "400": { "$ref": "#/components/responses/400BadRequest" }, "403": { "$ref": "#/components/responses/403Forbidden" }, "500": { "$ref": "#/components/responses/500InternalServer" } } } } } } ```