Inserts a new node into the campaign sequence. Draft campaigns only — every mutation on this collection is gated on status === "draft".This collection exposes three verbs:
Verb
Operation
Purpose
POST
addSequenceNode
Insert a new node (this page). Omit position to drop it right before the terminal end node.
To edit a node’s content (subject, body, delay values, AI purpose), use updateSequenceNode against the singular /sequence/nodes/{nodeId} route. Type is immutable after creation — to change it, delete and re-add.Every mutation on this collection is backed by an atomic Postgres RPC with row-level locking, so concurrent adds, moves, and deletes can’t corrupt the position ordering.
AI agent notes
Typical build order.
POST /api/campaigns to create a draft.
Loop over your desired nodes and POST /api/campaigns/{id}/sequence/nodes for each — omit position and every node lands just before the auto-inserted terminal end.
When done, POST /api/campaigns/{id}/launch.
Channel validation. The parent campaign’s type determines which node kinds are legal:
Read-back fallback. The response is normally { sequence_nodes: [...] } — the full list, already ordered. On the rare occasion the post-mutation read-back fails, the server returns { mutated: true, node_id }. In that case refetch via GET /api/campaigns/{id}.Position omitted = before the end. Don’t set position unless you specifically need to insert somewhere other than the natural end-of-sequence slot. The server handles ordering.AI nodes. Adding { type: "ai" } creates the base row; populate purpose and output_type with a follow-up PUT /api/campaigns/{id}/sequence/nodes/{nodeId} call.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
id
string
required
Campaign UUID
Body
application/json
type
enum<string>
required
Available options:
connection_request,
message,
email,
delay,
ai,
end
position
integer | null
Required range: 0 <= x <= 9007199254740991
subject
string | null
body
string | null
signature
string | null
include_message
boolean | null
is_reply
boolean | null
delay_days
integer | null
Required range: 0 <= x <= 9007199254740991
delay_hours
integer | null
Required range: 0 <= x <= 9007199254740991
delay_minutes
integer | null
Required range: 0 <= x <= 9007199254740991
{key}
any
Response
Node inserted. Returns the fresh ordered list, or a mutation fallback when read-back fails.
Option 1
Option 2
sequence_nodes
object[]
required
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pixie Docs","description":"GTM intelligence platform for founders","colors":{"primary":"#00308F","light":"#4169E1","dark":"#001F5C"},"logo":{"light":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-light.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6f6ed3122fe70c6655b8e0f15a633429","dark":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-dark.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6e0cea776235f47330d3f503b89d3014"},"favicon":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/favicon.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=4f98900fd6bf3ca38403f68e7aef9f09","api":{"openapi":"api-reference/openapi.json","params":{"post":["x-param-pill"]}},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"puffle-a7721060","hasAudioNarration":false,"actualSubdomain":"puffle-a7721060","customDomains":["docs.pixiegtm.com"],"gitSource":{"type":"github","owner":"developiq-ai","repo":"pixie-app","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adf4cb1f325da4ba4e0ec9b","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Endpoints","count":71},{"language":"default","tag":"Lead Finder","count":12},{"language":"default","tag":"Outbound","count":11},{"language":"default","tag":"Unibox","count":7},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Email Inboxes","count":6},{"language":"default","tag":"Sending Domains","count":6},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Outbound Contacts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".pixie-welcome-callout{display:flex;gap:16px;align-items:flex-start;margin:32px 0 24px;padding:18px 20px;border:1px solid #7dd3a8;border-radius:10px;background:#f1fbf5;color:#047857}.pixie-welcome-callout-icon{flex:none;color:#059669;font-size:20px;line-height:1.3}.pixie-welcome-callout-title{display:block;margin:0 0 12px;color:#047857;font-weight:700}.pixie-welcome-callout-copy{display:block;color:#047857}html.dark .pixie-welcome-callout{border-color:#047857;background:#001f12;color:#34d399}html.dark .pixie-welcome-callout-icon,html.dark .pixie-welcome-callout-title,html.dark .pixie-welcome-callout-copy{color:#34d399!important}"}],"page":{"pagePath":"api-reference/campaigns/add-sequence-node","slug":"/api-reference/campaigns/add-sequence-node","pageMetadata":{"title":"Add Node","description":"Insert a new node into a draft campaign's sequence. Also the home page for moving and deleting nodes on the same collection.","openapi":"post /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/add-sequence-node"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Insert a new node into a draft campaign’s sequence. Also the home page for moving and deleting nodes on the same collection.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`CLI:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pixie`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` campaign`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sequence`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` node`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`typ`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pixie`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` campaign`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sequence`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` node`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`typ`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --position`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`positio`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --subject`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`subjec`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`t`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --body`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`bod`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`y`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --signature`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`signatur`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --include-message`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`include-messag`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --is-reply`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`is-repl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`y`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --delay-days`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`delay-day`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --delay-hours`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`delay-hour`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --delay-minutes`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`delay-minute`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`s`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Inserts a new node into the campaign sequence. `,_jsx(_components.strong,{children:`Draft campaigns only`}),` — every mutation on this collection is gated on `,_jsx(_components.code,{children:`status === \"draft\"`}),`.`]}),`\n`,_jsx(_components.p,{children:`This collection exposes three verbs:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Verb`}),_jsx(_components.th,{children:`Operation`}),_jsx(_components.th,{children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`addSequenceNode`})}),_jsxs(_components.td,{children:[`Insert a new node (this page). Omit `,_jsx(_components.code,{children:`position`}),` to drop it right before the terminal `,_jsx(_components.code,{children:`end`}),` node.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PATCH`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`moveSequenceNode`})}),_jsxs(_components.td,{children:[`Reorder an existing node — see `,_jsx(_components.a,{href:`/api-reference/campaigns/update-sequence-node`,children:`Move a sequence node`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DELETE`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteSequenceNode`})}),_jsxs(_components.td,{children:[`Remove a node — see `,_jsx(_components.a,{href:`/api-reference/campaigns/delete-sequence-node`,children:`Delete a sequence node`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`To edit a node’s content (subject, body, delay values, AI purpose), use `,_jsx(_components.a,{href:`/api-reference/campaigns/update-sequence-node`,children:_jsx(_components.code,{children:`updateSequenceNode`})}),` against the singular `,_jsx(_components.code,{children:`/sequence/nodes/{nodeId}`}),` route. Type is immutable after creation — to change it, delete and re-add.`]}),`\n`,_jsxs(_components.p,{children:[`Every mutation on this collection is backed by an atomic Postgres RPC with row-level locking, so concurrent adds, moves, and deletes can’t corrupt the `,_jsx(_components.code,{children:`position`}),` ordering.`]}),`\n`,_jsx(Heading,{level:`2`,id:`ai-agent-notes`,children:`AI agent notes`}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Typical build order.`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /api/campaigns`}),` to create a draft.`]}),`\n`,_jsxs(_components.li,{children:[`Loop over your desired nodes and `,_jsx(_components.code,{children:`POST /api/campaigns/{id}/sequence/nodes`}),` for each — omit `,_jsx(_components.code,{children:`position`}),` and every node lands just before the auto-inserted terminal `,_jsx(_components.code,{children:`end`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`When done, `,_jsx(_components.code,{children:`POST /api/campaigns/{id}/launch`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Channel validation.`}),` The parent campaign’s `,_jsx(_components.code,{children:`type`}),` determines which node kinds are legal:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`linkedin`}),` campaigns accept `,_jsx(_components.code,{children:`connection_request`}),`, `,_jsx(_components.code,{children:`message`}),`, `,_jsx(_components.code,{children:`delay`}),`, `,_jsx(_components.code,{children:`ai`}),`, `,_jsx(_components.code,{children:`end`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email`}),` campaigns accept `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`delay`}),`, `,_jsx(_components.code,{children:`ai`}),`, `,_jsx(_components.code,{children:`end`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Read-back fallback.`}),` The response is normally `,_jsx(_components.code,{children:`{ sequence_nodes: [...] }`}),` — the full list, already ordered. On the rare occasion the post-mutation read-back fails, the server returns `,_jsx(_components.code,{children:`{ mutated: true, node_id }`}),`. In that case refetch via `,_jsx(_components.code,{children:`GET /api/campaigns/{id}`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Position omitted = before the end.`}),` Don’t set `,_jsx(_components.code,{children:`position`}),` unless you specifically need to insert somewhere other than the natural end-of-sequence slot. The server handles ordering.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`AI nodes.`}),` Adding `,_jsx(_components.code,{children:`{ type: \"ai\" }`}),` creates the base row; populate `,_jsx(_components.code,{children:`purpose`}),` and `,_jsx(_components.code,{children:`output_type`}),` with a follow-up `,_jsx(_components.code,{children:`PUT /api/campaigns/{id}/sequence/nodes/{nodeId}`}),` call.`]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add Node","description":"Insert a new node into a draft campaign's sequence. Also the home page for moving and deleting nodes on the same collection.","openapi":"post /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/add-sequence-node"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"AI agent notes","slug":"ai-agent-notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/puffle-a7721060/c08f9ef5836940ef/ai-agent-notes-bottom.js"],"openApiReferenceData":{"operation":{"operationId":"addSequenceNode","summary":"Add Node","description":"Insert a new node into a draft campaign's sequence. Also the home page for moving and deleting nodes on the same collection.","tags":["Campaigns"],"parameters":["dc3f1684-ae01-49cf-b420-41704a508474"],"requestBody":"1f841f40-7a49-4362-abe2-adef4cea502a","responses":{"200":"e8e5e668-598a-4c58-9d9b-510241a80dae","400":"abd57e03-8922-4c78-96d1-5bb46626c942","401":"e16d12f2-f133-4c4e-a66f-d570107c279e","404":"5a8ecfbc-bca5-48ba-95c8-032610de267c","500":"46e04570-33f4-44f1-a53d-e7c3787bead4"},"x-pixie-cli":{"command":"pixie campaign sequence node add","auth":"apiKey","flags":[{"name":"id","from":"params.id","type":"string","required":true,"description":"Campaign UUID"},{"name":"type","from":"body.type","type":"string","required":true},{"name":"position","from":"body.position","type":"string","required":false},{"name":"subject","from":"body.subject","type":"string","required":false},{"name":"body","from":"body.body","type":"string","required":false},{"name":"signature","from":"body.signature","type":"string","required":false},{"name":"include-message","from":"body.include_message","type":"string","required":false},{"name":"is-reply","from":"body.is_reply","type":"string","required":false},{"name":"delay-days","from":"body.delay_days","type":"string","required":false},{"name":"delay-hours","from":"body.delay_hours","type":"string","required":false},{"name":"delay-minutes","from":"body.delay_minutes","type":"string","required":false}]},"method":"post","type":"path","servers":["3f705fd1-36b3-48c2-9ff5-0b216d4c8835"],"security":["389a9986-625f-46f1-8c08-80e2d40d3784"],"path":"/api/campaigns/{id}/sequence/nodes","baseUrlOptions":["https://app.pixiegtm.com"],"title":"Add Node","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dc3f1684-ae01-49cf-b420-41704a508474":{"name":"id","in":"path","required":true,"schema":{"type":"string","description":"Campaign UUID","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["connection_request","message","email","delay","ai","end"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"position":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"position.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"position.oneOf.1","typeLabel":"null"}],"uniqueKey":"position","typeLabel":"integer | null"},"subject":{"oneOf":[{"type":"string","uniqueKey":"subject.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"subject.oneOf.1","typeLabel":"null"}],"uniqueKey":"subject","typeLabel":"string | null"},"body":{"oneOf":[{"type":"string","uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"body.oneOf.1","typeLabel":"null"}],"uniqueKey":"body","typeLabel":"string | null"},"signature":{"oneOf":[{"type":"string","uniqueKey":"signature.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"signature.oneOf.1","typeLabel":"null"}],"uniqueKey":"signature","typeLabel":"string | null"},"include_message":{"oneOf":[{"type":"boolean","uniqueKey":"include_message.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"include_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"include_message","typeLabel":"boolean | null"},"is_reply":{"oneOf":[{"type":"boolean","uniqueKey":"is_reply.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"is_reply.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_reply","typeLabel":"boolean | null"},"delay_days":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_days.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_days.oneOf.1","typeLabel":"null"}],"uniqueKey":"delay_days","typeLabel":"integer | null"},"delay_hours":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_hours.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_hours.oneOf.1","typeLabel":"null"}],"uniqueKey":"delay_hours","typeLabel":"integer | null"},"delay_minutes":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_minutes.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"delay_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"delay_minutes","typeLabel":"integer | null"}},"required":["type"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"additionalProperties","typeLabel":"any"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"position":4503599627370495,"subject":"\u003cstring>","body":"\u003cstring>","signature":"\u003cstring>","include_message":true,"is_reply":true,"delay_days":4503599627370495,"delay_hours":4503599627370495,"delay_minutes":4503599627370495}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e8e5e668-598a-4c58-9d9b-510241a80dae":{"description":"Node inserted. Returns the fresh ordered list, or a mutation fallback when read-back fails.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["sequence_nodes"],"properties":{"sequence_nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"String value with endpoint-specific validation.","isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].id","typeLabel":"string"},"campaign_id":{"type":"string","description":"String value with endpoint-specific validation.","isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].campaign_id","typeLabel":"string"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].position","typeLabel":"integer"},"type":{"type":"string","enum":["connection_request","message","email","delay","ai","end"],"isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"subject":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].subject.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].subject.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].subject","typeLabel":"string | null"},"body":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body","typeLabel":"string | null"},"body_html":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body_html.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body_html.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].body_html","typeLabel":"string | null"},"signature":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].signature.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].signature.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].signature","typeLabel":"string | null"},"from_name":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].from_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].from_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].from_name","typeLabel":"string | null"},"reply_to":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].reply_to.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].reply_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].reply_to","typeLabel":"string | null"},"cc":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].cc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].cc.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].cc","typeLabel":"string | null"},"bcc":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].bcc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].bcc.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].bcc","typeLabel":"string | null"},"attachments":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].attachments.oneOf.0.items.[INDEX]","typeLabel":"any"},"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].attachments.oneOf.0","typeLabel":"any[]"},{"type":"null","items":{"oneOf":[{}]},"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].attachments.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].attachments","typeLabel":"any[] | null"},"include_message":{"oneOf":[{"type":"boolean","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].include_message.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].include_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].include_message","typeLabel":"boolean | null"},"is_reply":{"oneOf":[{"type":"boolean","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].is_reply.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].is_reply.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].is_reply","typeLabel":"boolean | null"},"delay_days":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_days.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_days.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_days","typeLabel":"integer | null"},"delay_hours":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_hours.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_hours.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_hours","typeLabel":"integer | null"},"delay_minutes":{"oneOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_minutes.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":9007199254740991,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].delay_minutes","typeLabel":"integer | null"},"ai_node":{"oneOf":[{"type":"object","properties":{"output_type":{"type":"string","enum":["email","message"],"isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node.oneOf.0.output_type","typeLabel":"enum\u003cstring>"}},"required":["output_type"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"output_type":{"type":"string","enum":["email","message"]}},"required":["output_type"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node.oneOf.1.additionalProperties","typeLabel":"any"},"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX].ai_node","typeLabel":"object | null"}},"required":["id","campaign_id","position","type"],"additionalProperties":false,"uniqueKey":"oneOf.0.sequence_nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.sequence_nodes","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["mutated"],"properties":{"mutated":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"oneOf.1.mutated","typeLabel":"enum\u003cboolean>"},"node_id":{"type":"string","description":"String value with endpoint-specific validation.","uniqueKey":"oneOf.1.node_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sequence_nodes":[{"id":"\u003cstring>","campaign_id":"\u003cstring>","position":4503599627370495,"type":"connection_request","subject":"\u003cstring>","body":"\u003cstring>","body_html":"\u003cstring>","signature":"\u003cstring>","from_name":"\u003cstring>","reply_to":"\u003cstring>","cc":"\u003cstring>","bcc":"\u003cstring>","attachments":["\u003cunknown>"],"include_message":true,"is_reply":true,"delay_days":4503599627370495,"delay_hours":4503599627370495,"delay_minutes":4503599627370495,"ai_node":{"output_type":"email"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"abd57e03-8922-4c78-96d1-5bb46626c942":{"description":"Validation failure, malformed RPC input, or non-draft campaign.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e16d12f2-f133-4c4e-a66f-d570107c279e":{"description":"Missing or invalid authentication.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5a8ecfbc-bca5-48ba-95c8-032610de267c":{"description":"Campaign doesn't exist or isn't owned by the caller.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"46e04570-33f4-44f1-a53d-e7c3787bead4":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"389a9986-625f-46f1-8c08-80e2d40d3784":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"pk_live_...","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"3f705fd1-36b3-48c2-9ff5-0b216d4c8835":{"url":"https://app.pixiegtm.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"pk_live_...","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"puffle-a7721060","siteName":"Pixie Docs","title":"Add Node - Pixie Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T08:33:02.553Z","originalFileLocation":"api-reference/campaigns/add-sequence-node.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Insert a new node into a draft campaign\u0026#x27;s sequence. Also the home page for moving and deleting nodes on the same collection.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pixie Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add Node - Pixie Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Insert a new node into a draft campaign\u0026#x27;s sequence. Also the home page for moving and deleting nodes on the same collection.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pixie Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://puffle-a7721060.mintlify.site/_mintlify/api/og/v2?division=Outbound+Sequence\u0026amp;title=Add+Node\u0026amp;description=Insert+a+new+node+into+a+draft+campaign%27s+sequence.+Also+the+home+page+for+moving+and+deleting+nodes+on+the+same+collection.\u0026amp;theme=28e6c6df0ec34bca1003614e\u0026amp;signature=1004e52b9bfe23d66ea427dcf38de91eebe0839da122d4770953f8536a97aa95\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add Node - Pixie Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Insert a new node into a draft campaign\u0026#x27;s sequence. Also the home page for moving and deleting nodes on the same collection.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://puffle-a7721060.mintlify.site/_mintlify/api/og/v2?division=Outbound+Sequence\u0026amp;title=Add+Node\u0026amp;description=Insert+a+new+node+into+a+draft+campaign%27s+sequence.+Also+the+home+page+for+moving+and+deleting+nodes+on+the+same+collection.\u0026amp;theme=28e6c6df0ec34bca1003614e\u0026amp;signature=1004e52b9bfe23d66ea427dcf38de91eebe0839da122d4770953f8536a97aa95\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pixie Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00308F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/campaigns/add-sequence-node.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pixiegtm.com/#organization\",\"name\":\"Pixie Docs\",\"url\":\"https://docs.pixiegtm.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-light.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6f6ed3122fe70c6655b8e0f15a633429\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pixiegtm.com#website\",\"name\":\"Pixie Docs\",\"url\":\"https://docs.pixiegtm.com\",\"publisher\":{\"@id\":\"https://docs.pixiegtm.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node#webpage\",\"url\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node\",\"name\":\"Add Node\",\"description\":\"Insert a new node into a draft campaign's sequence. Also the home page for moving and deleting nodes on the same collection.\",\"dateModified\":\"2026-08-25T08:33:02.553Z\",\"isPartOf\":{\"@id\":\"https://docs.pixiegtm.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.pixiegtm.com/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add Node\",\"item\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node#apireference\",\"headline\":\"Add Node\",\"name\":\"Add Node\",\"description\":\"Insert a new node into a draft campaign's sequence. Also the home page for moving and deleting nodes on the same collection.\",\"url\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pixiegtm.com/api-reference/campaigns/add-sequence-node#webpage\"},\"dateModified\":\"2026-08-25T08:33:02.553Z\",\"publisher\":{\"@id\":\"https://docs.pixiegtm.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pixiegtm.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pixie Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pixie Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/campaigns/add-sequence-node.md","siteName":"Pixie Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"API Reference","icon":"terminal","groups":[{"group":"Endpoints","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"API Keys","href":"/api-reference/api-keys/overview"},{"group":"Lead Finder","pages":[{"title":"List Lead Finder searches and latest run status","openapi":"get /api/lead-finder","href":"/api-reference/lead-finder/lead-finder.list"},{"title":"Create a Lead Finder search and start its first run","openapi":"post /api/lead-finder","href":"/api-reference/lead-finder/lead-finder.create"},{"title":"Get one Lead Finder search and paginated results","openapi":"get /api/lead-finder/{id}","href":"/api-reference/lead-finder/lead-finder.get"},{"title":"Update one Lead Finder search","openapi":"patch /api/lead-finder/{id}","href":"/api-reference/lead-finder/lead-finder.update"},{"title":"Resolve an exact Lead Finder title without selecting between duplicates","openapi":"get /api/lead-finder/resolve","href":"/api-reference/lead-finder/lead-finder.resolve"},{"title":"List sources available for new Lead Finder searches","openapi":"get /api/lead-finder/sources","href":"/api-reference/lead-finder/lead-finder.sources"},{"title":"Query reviewed Lead Finder enrichment values","openapi":"post /api/lead-finder/{id}/results/query","href":"/api-reference/lead-finder/lead-finder.query-results"},{"title":"Get one reviewed Lead Finder enrichment profile","openapi":"get /api/lead-finder/{id}/results/{resultId}/enrichment","href":"/api-reference/lead-finder/lead-finder.get-result-enrichment"},{"title":"List reviewed Lead Finder enrichment fields","openapi":"get /api/lead-finder/{id}/enrichment-fields","href":"/api-reference/lead-finder/lead-finder.enrichment-fields"},{"title":"Run every eligible Lead Finder search","openapi":"post /api/lead-finder/run","href":"/api-reference/lead-finder/lead-finder.run-all"},{"title":"Run one Lead Finder search","openapi":"post /api/lead-finder/{id}/run","href":"/api-reference/lead-finder/lead-finder.run-one"},{"title":"Stop the active run for one Lead Finder search without changing its future schedule","openapi":"post /api/lead-finder/{id}/stop","href":"/api-reference/lead-finder/lead-finder.stop-one"}]},{"group":"Outbound","pages":[{"title":"List Outbound","openapi":"get /api/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Get Outbound","openapi":"get /api/campaigns/{id}","href":"/api-reference/campaigns/get-campaign"},{"title":"Create Draft Outbound","openapi":"post /api/campaigns","href":"/api-reference/campaigns/create-draft-campaign"},{"title":"Update Outbound","openapi":"patch /api/campaigns/{id}","href":"/api-reference/campaigns/update-campaign"},{"title":"Delete Campaign","openapi":"delete /api/campaigns/{id}","href":"/api-reference/campaigns/delete-campaign"},{"title":"Launch Outbound","openapi":"post /api/campaigns/{id}/launch","href":"/api-reference/campaigns/launch-campaign"},{"title":"Pause Campaign","openapi":"post /api/campaigns/{id}/pause","href":"/api-reference/campaigns/pause-campaign"},{"title":"Resume Campaign","openapi":"post /api/campaigns/{id}/resume","href":"/api-reference/campaigns/resume-campaign"},{"title":"List outbound sender mapping","openapi":"get /api/campaigns/mapping","href":"/api-reference/campaigns/list-outbound-sender-mapping"},{"title":"Get durable campaign message metrics","openapi":"get /api/campaigns/{id}/message-metrics","href":"/api-reference/campaigns/get-campaign-message-metrics"},{"title":"Get Senders for Campaign","openapi":"get /api/campaigns/{id}/senders","href":"/api-reference/campaigns/get-senders-for-campaign"}]},{"group":"Outbound Contacts","pages":[{"title":"Get Leads in Campaign","openapi":"get /api/campaigns/{id}/leads","href":"/api-reference/campaigns/get-leads-in-campaign"},{"title":"Add Leads to Campaign","openapi":"post /api/campaigns/{id}/leads","href":"/api-reference/campaigns/add-leads-to-campaign"},{"title":"Update Lead in Campaign","openapi":"patch /api/campaigns/{id}/leads","href":"/api-reference/campaigns/update-lead-in-campaign"},{"title":"Remove Leads from Campaign","openapi":"delete /api/campaigns/{id}/leads","href":"/api-reference/campaigns/remove-leads-from-campaign"},{"title":"Import Leads from List to Campaign","description":"Bulk-import every row of a user-owned list into a campaign as leads, pulling enrichment data from profile_data.","openapi":"post /api/campaigns/{id}/leads/import-from-list","href":"/api-reference/campaigns/import-leads-from-list-to-campaign"}]},{"group":"Outbound Sequence","pages":[{"title":"Add Node","openapi":"post /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/add-sequence-node"},{"title":"Update Node","description":"Patch a single sequence node's content — subject, body, delays, or AI extension. Draft campaigns only.","openapi":"put /api/campaigns/{id}/sequence/nodes/{nodeId}","href":"/api-reference/campaigns/update-sequence-node"},{"title":"Reorder Node","openapi":"patch /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/move-sequence-node"},{"title":"Delete Node","openapi":"delete /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/delete-sequence-node"}]},{"group":"Outbound Messages","pages":[{"title":"List Generated Messages","openapi":"get /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/list-campaign-generated-messages"},{"title":"Generate Messages","openapi":"post /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/generate-campaign-messages"},{"title":"Edit Generated Message","openapi":"patch /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/update-campaign-generated-message"}]},{"group":"Outbound Settings","pages":[{"title":"Get Campaign Settings","openapi":"get /api/campaigns/settings","href":"/api-reference/campaigns/get-campaign-settings"},{"title":"Update Campaign Settings","openapi":"put /api/campaigns/settings","href":"/api-reference/campaigns/update-campaign-settings"}]},{"group":"Unibox","pages":[{"title":"Get Threads","openapi":"get /api/threads","href":"/api-reference/unibox/list-threads"},{"title":"Create Thread","openapi":"post /api/threads","href":"/api-reference/unibox/create-thread"},{"title":"Get Thread","openapi":"get /api/threads/{id}","href":"/api-reference/unibox/get-thread"},{"title":"Update Thread","openapi":"patch /api/threads/{id}","href":"/api-reference/unibox/update-thread"},{"title":"Delete Draft Thread","openapi":"delete /api/threads/{id}","href":"/api-reference/unibox/discard-draft-thread"},{"title":"Get Messages","openapi":"get /api/threads/{id}/messages","href":"/api-reference/unibox/list-thread-messages"},{"title":"Send Message","openapi":"post /api/threads/{id}/messages","href":"/api-reference/unibox/send-thread-message"}]},{"group":"Senders","pages":[{"title":"List Senders","openapi":"get /api/senders","href":"/api-reference/senders/list-senders"},{"title":"Get Sender Details","openapi":"get /api/senders/{id}","href":"/api-reference/senders/get-sender-details"},{"title":"Get Sender Schedule","openapi":"get /api/senders/{id}/schedule","href":"/api-reference/senders/get-account-schedule"}]},{"group":"Email Inboxes","pages":[{"title":"List Inboxes","openapi":"get /api/email/accounts","href":"/api-reference/senders/list-email-accounts"},{"title":"Create Inbox","openapi":"post /api/email/accounts","href":"/api-reference/senders/create-email-account"},{"title":"Update Inbox","openapi":"patch /api/email/accounts/{id}","href":"/api-reference/senders/update-email-account"},{"title":"Retry Inbox Warmup","openapi":"patch /api/email/accounts/{id}/retry-warmup","href":"/api-reference/senders/retry-account-warmup"},{"title":"Get Warmup Analytics","openapi":"get /api/email/accounts/warmup-analytics","href":"/api-reference/senders/get-warmup-analytics"},{"title":"Delete Inbox","openapi":"delete /api/email/accounts/{id}","href":"/api-reference/senders/delete-email-account"}]},{"group":"Sending Domains","pages":[{"title":"List Sending Domains","openapi":"get /api/email/domains","href":"/api-reference/senders/list-email-domains"},{"title":"Create Sending Domain","openapi":"post /api/email/domains","href":"/api-reference/senders/create-email-domain"},{"title":"Verify Domain","openapi":"post /api/email/domains/{id}/verify","href":"/api-reference/senders/verify-email-domain"},{"title":"DNS Records","openapi":"get /api/email/domains/{id}/dns-records","href":"/api-reference/senders/get-email-domain-dns-records"},{"title":"Update Domain Status","openapi":"patch /api/email/domains/{id}","href":"/api-reference/senders/update-email-domain"},{"title":"Delete Sending Domain","openapi":"delete /api/email/domains/{id}","href":"/api-reference/senders/delete-email-domain"}]},{"group":"Accounts","pages":[{"title":"Get Profile","openapi":"get /api/account","href":"/api-reference/accounts/get-account"},{"title":"Update Profile","openapi":"patch /api/account","href":"/api-reference/accounts/update-account"},{"title":"Get Company Profile","openapi":"get /api/context","href":"/api-reference/accounts/list-context"},{"title":"Update Company Profile","openapi":"put /api/context","href":"/api-reference/accounts/update-context"},{"title":"Approve onboarding section","openapi":"post /api/onboarding/approve-section","href":"/api-reference/accounts/approve-onboarding-section"},{"title":"Complete onboarding","openapi":"post /api/onboarding/complete","href":"/api-reference/accounts/complete-onboarding"}]},{"group":"Billing","pages":[{"title":"Start hosted billing checkout","openapi":"post /api/billing/checkout","href":"/api-reference/billing/billing.checkout"}]},{"group":"Discovery Pass","pages":[{"title":"Activate eligible Discovery Pass","openapi":"post /api/test-access/auto-grant","href":"/api-reference/discovery-pass/test-access.auto-grant"},{"title":"Get Discovery Pass status","openapi":"get /api/test-access","href":"/api-reference/discovery-pass/test-access.get"},{"title":"Redeem Discovery Pass code","openapi":"post /api/test-access/redeem","href":"/api-reference/discovery-pass/test-access.redeem"}]}]}]},{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/guides/agent-playbook"}]}]},"basePath":"","title":"Add Node - Pixie Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}