Get Started
Endpoints
- Projects
- User Invitations
- Project Members
- Connections
- Flows
- Flow Runs
- Sample Data
- Pieces
- Project Releases
- Global Connections
- Git Sync
- Folders
- Flow Templates
- MCP Servers
- MCP pieces
Flows
Create Flow
Create a flow
POST
/
v1
/
flows
curl --request POST \
--url https://cloud.activepieces.com/api/v1/flows \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"displayName": "<string>",
"folderId": "<string>",
"folderName": "<string>",
"projectId": "<string>",
"metadata": {}
}'
{
"id": "<string>",
"created": "<string>",
"updated": "<string>",
"projectId": "<string>",
"externalId": "<string>",
"folderId": "<string>",
"status": "ENABLED",
"schedule": {
"type": "CRON_EXPRESSION",
"cronExpression": "<string>",
"timezone": "<string>",
"failureCount": 123
},
"publishedVersionId": "<string>",
"metadata": {},
"version": {
"id": "<string>",
"created": "<string>",
"updated": "<string>",
"flowId": "<string>",
"displayName": "<string>",
"trigger": {
"name": "<string>",
"valid": true,
"displayName": "<string>",
"nextAction": "<any>",
"type": "PIECE_TRIGGER",
"settings": {
"pieceName": "<string>",
"pieceVersion": "<string>",
"pieceType": "CUSTOM",
"packageType": "ARCHIVE",
"triggerName": "<string>",
"input": {},
"inputUiInfo": {
"sampleDataFileId": "<string>",
"sampleDataInputFileId": "<string>",
"lastTestDate": "<string>",
"customizedInputs": {},
"schema": {},
"currentSelectedData": "<any>"
}
}
},
"updatedBy": "<string>",
"valid": true,
"schemaVersion": "<string>",
"state": "LOCKED"
}
}
Authorizations
Use your api key generated from the admin console
Body
application/json
Response
201 - application/json
Default Response
Available options:
ENABLED
Available options:
PIECE_TRIGGER
Available options:
CUSTOM
Available options:
ARCHIVE
Available options:
LOCKED
curl --request POST \
--url https://cloud.activepieces.com/api/v1/flows \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"displayName": "<string>",
"folderId": "<string>",
"folderName": "<string>",
"projectId": "<string>",
"metadata": {}
}'
{
"id": "<string>",
"created": "<string>",
"updated": "<string>",
"projectId": "<string>",
"externalId": "<string>",
"folderId": "<string>",
"status": "ENABLED",
"schedule": {
"type": "CRON_EXPRESSION",
"cronExpression": "<string>",
"timezone": "<string>",
"failureCount": 123
},
"publishedVersionId": "<string>",
"metadata": {},
"version": {
"id": "<string>",
"created": "<string>",
"updated": "<string>",
"flowId": "<string>",
"displayName": "<string>",
"trigger": {
"name": "<string>",
"valid": true,
"displayName": "<string>",
"nextAction": "<any>",
"type": "PIECE_TRIGGER",
"settings": {
"pieceName": "<string>",
"pieceVersion": "<string>",
"pieceType": "CUSTOM",
"packageType": "ARCHIVE",
"triggerName": "<string>",
"input": {},
"inputUiInfo": {
"sampleDataFileId": "<string>",
"sampleDataInputFileId": "<string>",
"lastTestDate": "<string>",
"customizedInputs": {},
"schema": {},
"currentSelectedData": "<any>"
}
}
},
"updatedBy": "<string>",
"valid": true,
"schemaVersion": "<string>",
"state": "LOCKED"
}
}