Add actions to an outcome

Appends one or more nodes to the end of an outcome’s action chain. You send the actions, and the server creates their node ids, links and positions.

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 has a 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.

Each action must include its full settings. To save an action with incomplete settings, use PUT /workflow. A chain that already ends in a branch cannot be added to. Change it in the dashboard workflow editor or with PUT /workflow.

Send an Idempotency-Key header if you may retry. 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": "Something here doesn't look right. Please check it and try again."
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Please sign in to continue."
}

{
  "success": false,
  "error": "InsufficientScope",
  "message": "This access key does not allow this action. Please ask your account admin to change its permissions.",
  "requiredScope": "campaign_workflows:write"
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "We couldn't find that. It may have been moved or deleted."
}

{
  "success": false,
  "error": "CONFLICT",
  "message": "This changed while you were working on it. Please refresh and try again."
}

{
  "success": false,
  "error": "TooManyRequests",
  "message": "That's a lot at once. Please wait a moment and try again."
}

{
  "success": false,
  "error": "Internal",
  "message": "Something went wrong on our side. Please try again in a moment.",
  "ref": "3f2b8c1e-7d4a-4f8e-9b6a-2c1d0e5f7a9b"
}

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.

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

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

The workflow version you read. Rejected with 409 if the stored version has moved on.

Required range: x >= 0

Example:

3

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

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": "Something here doesn't look right. Please check it and try again."
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Please sign in to continue."
}

{
  "success": false,
  "error": "InsufficientScope",
  "message": "This access key does not allow this action. Please ask your account admin to change its permissions.",
  "requiredScope": "campaign_workflows:write"
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "We couldn't find that. It may have been moved or deleted."
}

{
  "success": false,
  "error": "CONFLICT",
  "message": "This changed while you were working on it. Please refresh and try again."
}

{
  "success": false,
  "error": "TooManyRequests",
  "message": "That's a lot at once. Please wait a moment and try again."
}

{
  "success": false,
  "error": "Internal",
  "message": "Something went wrong on our side. Please try again in a moment.",
  "ref": "3f2b8c1e-7d4a-4f8e-9b6a-2c1d0e5f7a9b"
}

Developer setup

Agents

TFU Live

In-call Capabilities

Campaigns

Master agent

Phone Numbers

Caller ID

Voices

Projects

Calls

Contacts

Native Contacts

Native Calendar

Analytics

Billing

Add actions to an outcome

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response