Quickstart

In this page we are going to demonstrate how to create your first workflow in Port. We will build a simple self-service workflow that sends a webhook notification when triggered.

Set up

You can create workflows in Port using three approaches:

• Visual editor - Build workflows by dragging and connecting nodes in a visual graph.
• JSON editor - Define workflows directly in JSON for precise control.
• Build with AI - Describe your workflow in natural language and let AI generate it for you.

Using the visual editor

1. Go to the workflows page in Port.

2. Click + Workflow.

3. Fill out the Create new workflow form, then click Confirm.

4. Add action nodes by clicking on nodes in the left sidebar and connecting them to build your workflow.

5. Configure each node by clicking on it and editing its properties in the right panel.

6. Click Apply changes.

Using JSON

1. Click the {...} button to open the JSON editor.

2. Copy and paste the following JSON into the editor:

   Workflow JSON example (click to expand)

   {
     "identifier": "my-first-workflow",
     "title": "My First Workflow",
     "icon": "Workflow",
     "description": "A simple webhook workflow",
     "nodes": [
       {
         "identifier": "trigger",
         "title": "Start",
         "config": {
           "type": "SELF_SERVE_TRIGGER",
           "userInputs": {
             "properties": {
               "message": {
                 "type": "string",
                 "title": "Message",
                 "description": "The message to send"
               }
             },
             "required": ["message"]
           }
         }
       },
       {
         "identifier": "send-webhook",
         "title": "Send Webhook",
         "config": {
           "type": "WEBHOOK",
           "url": "https://example.com/webhook",
           "method": "POST",
           "body": {
             "message": "{{ .outputs.trigger.message }}"
           }
         }
       }
     ],
     "connections": [
       {
         "sourceIdentifier": "trigger",
         "targetIdentifier": "send-webhook"
       }
     ]
   }

3. Click Apply changes.

Build with AI

Port's AI assistant can help you build workflows using natural language:

1. Open the AI assistant on the right side of the workflow editor.

2. Describe what you want your workflow to do in natural language, for example:

   • "Create a workflow that sends a Slack notification when a service is deployed".
   • "Build a self-service workflow that creates a new GitHub repository".
   • "Make a workflow that updates an entity's status after a webhook response".

3. The AI will generate the workflow for you, which you can then review and modify as needed.

Tips for AI-assisted workflow building:

• Be specific about the trigger type (self-service vs event-based).
• Describe the actions you want to perform in sequence.
• Mention any conditions or branching logic needed.
• Specify the data you want to pass between nodes.
• Specify the secret names you want to use for authentication.

Next steps

Now that you've created your first workflow, explore these topics:

• Self-service trigger - Learn how to configure user inputs and triggers.
• Event trigger - Create workflows that respond to entity changes.
• Action nodes - Explore all available action types.
• Setup checklist - Resolve a workflow's missing integrations and secrets before it runs.
• Examples - See real-world workflow examples.