cURL

curl --request POST \
  --url https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "nodes": [
    {
      "type": "add-tag",
      "config": {
        "tags": [
          "booked_via_ai"
        ]
      }
    },
    {
      "type": "send-sms",
      "config": {
        "message": "Thanks for booking! See you soon."
      }
    }
  ]
}'

import requests

url = "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes"

payload = { "nodes": [
        {
            "type": "add-tag",
            "config": { "tags": ["booked_via_ai"] }
        },
        {
            "type": "send-sms",
            "config": { "message": "Thanks for booking! See you soon." }
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    nodes: [
      {type: 'add-tag', config: {tags: ['booked_via_ai']}},
      {type: 'send-sms', config: {message: 'Thanks for booking! See you soon.'}}
    ]
  })
};

fetch('https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'nodes' => [
        [
                'type' => 'add-tag',
                'config' => [
                                'tags' => [
                                                                'booked_via_ai'
                                ]
                ]
        ],
        [
                'type' => 'send-sms',
                'config' => [
                                'message' => 'Thanks for booking! See you soon.'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes"

	payload := strings.NewReader("{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "workflow": {
    "locationId": "loc_abc123",
    "campaignId": "cmp_123",
    "campaignConfig": {
      "callbackMode": "ai"
    },
    "nodes": {
      "tag_booked": {
        "id": "tag_booked",
        "type": "add-tag",
        "config": {
          "tags": [
            "booked_via_ai"
          ]
        }
      },
      "sms_reminder": {
        "id": "sms_reminder",
        "type": "send-sms",
        "config": {
          "message": "Thanks for booking! See you soon."
        }
      }
    },
    "edges": [
      {
        "id": "e_booked",
        "source": "tag_booked",
        "target": "sms_reminder"
      }
    ],
    "dispositionEntries": {
      "SUCCESS": "tag_booked"
    },
    "version": 3,
    "createdAt": "2026-07-01T09:15:22.000Z",
    "updatedAt": "2026-07-14T16:04:11.000Z"
  }
}

{
  "success": false,
  "error": "VALIDATION",
  "message": "Workflow graph must have a nodes object."
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Authentication required."
}

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "You do not have access to this project."
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Campaign not found on this project."
}

{
  "success": false,
  "error": "CONFLICT",
  "message": "The workflow changed since it was loaded. Re-read and retry."
}

{
  "success": false,
  "error": "RateLimited",
  "message": "Rate limit exceeded. Retry after a short delay."
}

Add actions to an outcome

The normal way to add steps. Append one or more nodes to the end of an outcome’s action chain. Prefer this over the whole-graph PUT for ordinary edits. You describe what should happen; the server derives the node ids, the edge ids, the branch handles and the canvas coordinates, which are the parts the PUT expects you to invent correctly.

Applied atomically: if any node in the list is rejected, nothing is written. Appending an action the chain already performs is a no-op rather than a duplicate, so a retry is safe.

Each entry is discriminated on type. Most types are { type, config }. A switch router is { type: "switch", cases: [{ condition, actions }], default } because one router produces a branch node plus a chain per case.

Unlike the PUT, per-node config IS required here — an action you are adding on purpose should be complete. Use the PUT if you want to save an unconfigured draft. A chain that already ends in a branch cannot be appended to; edit it in the builder.

Send an Idempotency-Key header if you may retry. This is the only operation here that creates, so a request that timed out is genuinely ambiguous. A repeat with the same key and the same body returns the original result instead of appending again; a repeat with the same key and a different body is rejected with 409.

Required API key scope: campaign_workflows:write.

POST

api

agent-builder

agents

{id}

campaign

workflow

outcomes

{outcome}

nodes

cURL

curl --request POST \
  --url https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "nodes": [
    {
      "type": "add-tag",
      "config": {
        "tags": [
          "booked_via_ai"
        ]
      }
    },
    {
      "type": "send-sms",
      "config": {
        "message": "Thanks for booking! See you soon."
      }
    }
  ]
}'

import requests

url = "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes"

payload = { "nodes": [
        {
            "type": "add-tag",
            "config": { "tags": ["booked_via_ai"] }
        },
        {
            "type": "send-sms",
            "config": { "message": "Thanks for booking! See you soon." }
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    nodes: [
      {type: 'add-tag', config: {tags: ['booked_via_ai']}},
      {type: 'send-sms', config: {message: 'Thanks for booking! See you soon.'}}
    ]
  })
};

fetch('https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'nodes' => [
        [
                'type' => 'add-tag',
                'config' => [
                                'tags' => [
                                                                'booked_via_ai'
                                ]
                ]
        ],
        [
                'type' => 'send-sms',
                'config' => [
                                'message' => 'Thanks for booking! See you soon.'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes"

	payload := strings.NewReader("{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.teamfollowup.ai/api/agent-builder/agents/{id}/campaign/workflow/outcomes/{outcome}/nodes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"nodes\": [\n    {\n      \"type\": \"add-tag\",\n      \"config\": {\n        \"tags\": [\n          \"booked_via_ai\"\n        ]\n      }\n    },\n    {\n      \"type\": \"send-sms\",\n      \"config\": {\n        \"message\": \"Thanks for booking! See you soon.\"\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "workflow": {
    "locationId": "loc_abc123",
    "campaignId": "cmp_123",
    "campaignConfig": {
      "callbackMode": "ai"
    },
    "nodes": {
      "tag_booked": {
        "id": "tag_booked",
        "type": "add-tag",
        "config": {
          "tags": [
            "booked_via_ai"
          ]
        }
      },
      "sms_reminder": {
        "id": "sms_reminder",
        "type": "send-sms",
        "config": {
          "message": "Thanks for booking! See you soon."
        }
      }
    },
    "edges": [
      {
        "id": "e_booked",
        "source": "tag_booked",
        "target": "sms_reminder"
      }
    ],
    "dispositionEntries": {
      "SUCCESS": "tag_booked"
    },
    "version": 3,
    "createdAt": "2026-07-01T09:15:22.000Z",
    "updatedAt": "2026-07-14T16:04:11.000Z"
  }
}

{
  "success": false,
  "error": "VALIDATION",
  "message": "Workflow graph must have a nodes object."
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Authentication required."
}

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "You do not have access to this project."
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Campaign not found on this project."
}

{
  "success": false,
  "error": "CONFLICT",
  "message": "The workflow changed since it was loaded. Re-read and retry."
}

{
  "success": false,
  "error": "RateLimited",
  "message": "Rate limit exceeded. Retry after a short delay."
}

Authorizations

Authorization

string

header

required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Headers

Idempotency-Key

string

Optional retry key for create-style operations. Reusing the same key with the same request returns the original result; reusing it with a different request returns 409.

Required string length: 1 - 255

Path Parameters

string

required

Agent id.

Minimum string length: 1

outcome

string

required

The call outcome whose chain to append to. Accepts the raw disposition (SUCCESS), any case (success), or the label the dashboard shows (On callback). Rejected with 400 if the agent's type can never emit it — see dispositions from GET /api/v2/projects/systems.

Minimum string length: 1

Query Parameters

locationId

string

Pair with campaignId; omit both for primary campaign.

Minimum string length: 1

campaignId

string

Pair with locationId; omit both for primary campaign.

Minimum string length: 1

Body

application/json

Request payload. Detailed schema pending — see the route handler.

nodes

object[]

required

Appended in order to the end of the outcome chain, as one atomic write.

Minimum array length: 1

A router to add. One router produces a branch node plus a linear chain per case, which is why the cases carry their own actions rather than being wired separately.

Option 1
Option 2

Show child attributes

expectedVersion

integer

Optimistic-concurrency guard: rejected with 409 if the stored version has moved on.

Required range: x >= 0

Example:

3

{key}

any

Response

The updated workflow.

success

boolean

required

Example:

true

workflow

object | null

required

Show child attributes

warnings

object[]

Everything about the graph that is worth knowing and was not worth refusing. Empty on a clean graph. Read this after a write: a 200 means the graph was stored, not that every node will do something.

Show child attributes

Agents

Skills & Tools

Campaigns

Campaign Workflows

Calls

Analytics

Projects

Power Dialer

Contacts

Phone Numbers

Voices

GHL

Add actions to an outcome

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response