---
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.

# Execute pre-schedule

Execute the pre-schedule.

This endpoint generates the [Scheduled payment executed](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-execution-1) event.


# 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": {
      "202Accepted": {
        "description": "Accepted"
      },
      "400BadRequest": {
        "description": "Bad request"
      },
      "403Forbidden": {
        "description": "Operation forbidden"
      },
      "404NotFound": {
        "description": "The specified resource was not found"
      },
      "500InternalServer": {
        "description": "Internal server error"
      }
    },
    "parameters": {
      "accountId": {
        "in": "path",
        "name": "accountId",
        "schema": {
          "type": "integer",
          "format": "int64"
        },
        "description": "Pismo account ID",
        "required": true
      },
      "scheduleId": {
        "in": "path",
        "name": "scheduleId",
        "schema": {
          "type": "string"
        },
        "description": "Schedule ID",
        "required": true
      }
    },
    "schemas": {
      "ExecuteRequest": {
        "type": "object",
        "description": "Request to execute an existing pre-schedule",
        "properties": {
          "pismo_metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      },
      "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"
        }
      }
    },
    "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/accounts/{accountId}/pre-schedules/{scheduleId}/execute": {
      "parameters": [
        {
          "$ref": "#/components/parameters/accountId"
        },
        {
          "$ref": "#/components/parameters/scheduleId"
        }
      ],
      "post": {
        "summary": "Execute pre-schedule",
        "description": "Execute the pre-schedule.\n\nThis endpoint generates the [Scheduled payment executed](https://developers.pismo.io/events/docs/scheduler-payments-scheduled-payments-execution-1) event.\n",
        "operationId": "post-execute-pre-schedule",
        "tags": [
          "Schedules"
        ],
        "requestBody": {
          "description": "Request processing body",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExecuteRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "$ref": "#/components/responses/202Accepted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServer"
          }
        }
      }
    }
  }
}
```