> ## Documentation Index > Fetch the complete documentation index at: https://hilos-40.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a flow execution > Create a Flow Execution of a Flow. ## OpenAPI ````yaml post /api/flow/{id}/run openapi: 3.0.3 info: title: Hilos API version: 1.0.0 description: >- All of the below API endpoints require API key authentication, get your token at https://app.hilos.io/dev/api-keys. To use this token, send with every request an `Authorization: Token ` header. Production API server is located at api.hilos.io using HTTPS. No versioning info is required for now. servers: - url: https://api.hilos.io description: Production Server security: [] paths: /api/flow/{id}/run: post: tags: - Flow Execution summary: Create a Flow Execution description: Create a Flow Execution of a Flow. operationId: Create a Flow Execution parameters: - in: path name: id schema: type: string format: uuid description: A Flow Id to create a Flow Execution. required: true examples: CreateByFlowId: value: a3ff7ee5-0c11-49e2-a0d6-7e316626f7b1 summary: Create by Flow Id requestBody: content: application/json: schema: $ref: '#/components/schemas/FlowExecutionCreateRequest' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/FlowExecutionCreateRequest' multipart/form-data: schema: $ref: '#/components/schemas/FlowExecutionCreateRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/FlowExecutionEdit' description: '' security: - tokenAuth: [] components: schemas: FlowExecutionCreateRequest: type: object properties: execute_for: $ref: '#/components/schemas/FlowExecutionCreateRequestExecuteForEnum' has_priority: type: boolean default: false description: >- Specify as True if you want this execution to close any other running flows or conversations. contact_list: type: array items: $ref: '#/components/schemas/PatchedContactEdit' required: - contact_list - execute_for FlowExecutionEdit: type: object properties: status: type: string readOnly: true description: The status of the Flow Execution. execute_for: $ref: '#/components/schemas/FlowExecutionExecuteForEnum' inbound_trigger_with: $ref: '#/components/schemas/InboundTriggerWithEnum' inbound_start_message: type: string nullable: true inbound_start_message_match_exact: type: boolean id: type: string format: uuid has_priority: type: boolean flow_execution_variables: type: object additionalProperties: {} start_on: type: string format: date-time nullable: true num_contacts: type: integer maximum: 2147483647 minimum: 0 expired: type: integer maximum: 2147483647 minimum: 0 running: type: integer maximum: 2147483647 minimum: 0 completed: type: integer maximum: 2147483647 minimum: 0 canceled: type: integer maximum: 2147483647 minimum: 0 failed: type: integer maximum: 2147483647 minimum: 0 created_on: type: string format: date-time title: Creado el avg_completion_time: type: string contact_filters: type: array items: $ref: '#/components/schemas/FlowExecutionContactFilterEdit' description: >- The filters to use to get the Contacts that the Flow Execution will run for. contact_list: type: array items: $ref: '#/components/schemas/PatchedContactEdit' description: The list of Contacts that the Flow Execution will run for. source: $ref: '#/components/schemas/FlowExecutionEditSourceEnum' is_hidden: type: boolean required: - execute_for - status FlowExecutionCreateRequestExecuteForEnum: enum: - LIST type: string PatchedContactEdit: type: object properties: phone: type: string maxLength: 30 first_name: type: string nullable: true maxLength: 100 last_name: type: string nullable: true maxLength: 100 email: type: string format: email nullable: true maxLength: 254 meta: type: object additionalProperties: {} external_url: type: string format: uri nullable: true maxLength: 200 is_deleted: type: boolean id: type: string format: uuid source: type: string default: website notes: type: array items: $ref: '#/components/schemas/ContactNote' readOnly: true created_on: type: string format: date-time title: Creado el tags: type: array items: $ref: '#/components/schemas/ContactTag' external_id: type: string nullable: true native_id: type: string nullable: true default_assignees: type: array items: type: integer contact_import: type: string format: uuid nullable: true default_channel: type: integer nullable: true wa_id: type: string nullable: true overwrite_tags: type: boolean default: false description: >- If true, the `tags` will be overwritten with the new value. If false, the new value will be merged with the existing value. Default is false. overwrite_default_assignees: type: boolean default: false description: >- If true, the `default_assignees` will be overwritten with the new value. If false, the new value will be merged with the existing value. Default is false. overwrite_meta: type: boolean default: false description: >- If true, the `meta` field will be overwritten with the new value. If false, the new value will be merged with the existing value. Default is false. FlowExecutionExecuteForEnum: enum: - FILTERS - LIST - ALL type: string InboundTriggerWithEnum: enum: - ANY_MESSAGE - TEXT - IMAGE - FILE type: string FlowExecutionContactFilterEdit: type: object properties: field: type: string comparison: $ref: '#/components/schemas/ComparisonEnum' value: type: string id: type: string format: uuid required: - comparison - field - value FlowExecutionEditSourceEnum: enum: - HUBSPOT - API - FRONTEND type: string ContactNote: type: object properties: id: type: integer readOnly: true notes: type: string contact: type: string format: uuid readOnly: true created_on: type: string format: date-time readOnly: true title: Creado el created_by: $ref: '#/components/schemas/SimpleUser' required: - contact - created_on - id - notes ContactTag: type: object properties: id: type: integer readOnly: true name: type: string maxLength: 100 required: - id - name ComparisonEnum: enum: - exact - '!exact' - gte - gt - lte - lt - isnull - '!isnull' - icontains - '!icontains' type: string SimpleUser: type: object properties: first_name: type: string maxLength: 150 last_name: type: string maxLength: 150 email: type: string format: email title: Email address maxLength: 254 id: type: integer readOnly: true profile_image: type: string format: uri nullable: true role: $ref: '#/components/schemas/UserRoleEnum' required: - id UserRoleEnum: enum: - AGENT - MANAGER - ADMIN - FINANCE type: string securitySchemes: tokenAuth: type: apiKey in: header name: Authorization description: Token-based authentication with required prefix "Token" ````