---
updatedAt: 2026-03-13T14:16:31.000Z
agentTools:
  projectIndex: https://docs.fulcrumapp.com/llms.txt
---

# Create Workflow

One of the tricky parts of making a new workflow is that you need each step to have their own unique ID [(in UUID format)](https://en.wikipedia.org/wiki/Universally_unique_identifier). The easiest way to do that is by generating a random UUID (look up `uuid generator` on your search engine of choice to quickly find a new ID) and then using these new IDs in your workflow steps. Make sure that the `next_steps` array in a workflow step references the valid ID of another step in your workflow.

**NOTE** if you receive a "Unique index violation" error when creating your workflows, you will need to make sure that the `id`s of your workflow steps are unique in your organization.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "rest-api",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.fulcrumapp.com/api",
      "description": "United States"
    },
    {
      "url": "https://api.fulcrumapp-au.com/api",
      "description": "Australia"
    },
    {
      "url": "https://api.fulcrumapp-ca.com/api",
      "description": "Canada"
    },
    {
      "url": "https://api.fulcrumapp-eu.com/api",
      "description": "European Union"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-ApiToken"
      }
    },
    "schemas": {
      "BadRequestResponse": {
        "type": "object",
        "description": "Bad request error response",
        "properties": {
          "error": {
            "type": "string",
            "example": "Bad Request"
          },
          "status": {
            "type": "integer",
            "example": 400
          }
        }
      },
      "EmptySuccessResponse": {
        "type": "object",
        "description": "Empty success response",
        "properties": {}
      },
      "WorkflowCreateRequest": {
        "type": "object",
        "required": [
          "workflow"
        ],
        "additionalProperties": false,
        "properties": {
          "workflow": {
            "type": "object",
            "required": [
              "name",
              "object_type",
              "object_resource_id",
              "steps",
              "event_type"
            ],
            "properties": {
              "name": {
                "type": "string",
                "nullable": true,
                "description": "Display name of the workflow"
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Optional description of the workflow"
              },
              "object_type": {
                "type": "string",
                "description": "Type of object the workflow targets (for example, form)"
              },
              "object_resource_id": {
                "type": "string",
                "description": "Identifier of the object resource associated with the workflow"
              },
              "event_type": {
                "type": "string",
                "description": "Type of event that triggers the workflow"
              },
              "steps": {
                "type": "array",
                "description": "Steps that define the workflow logic",
                "items": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "ApiToken": []
    }
  ],
  "paths": {
    "/v2/workflows.json": {
      "post": {
        "summary": "Create a workflow",
        "description": "",
        "operationId": "create-workflow",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowCreateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmptySuccessResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequestResponse"
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```