Replace a workflow

​

Path Parameters

​

Body

​

Steps

• Webhook headers are write only. A sendWebhook step takes headers as names and text values. We do not send the values back. Responses show headerNames in their place.
• Keep or change headers. Leave headers out to keep the saved ones. That works while the url stays on the same address. To move the step to another address (a different host, http or https, or port), send headers again, or send {} to remove them. Otherwise we answer 400.
• Header names and values. A header name must be a plain name, and Host, Content-Length, Transfer-Encoding and Connection are not allowed. A value must be text on one line.
• Webhook addresses. A new or changed url may not point to a private or internal address. We cannot check a url with a {{variable}} in it ahead of time.
• Secrets go in headers. Only headers are write only. The url (with its query), body and bodyFields come back when you read the workflow or its versions. Put tokens and keys in headers.
• DND. The API never saves or runs a step that turns DND off (updateContact with "dnc": "deactivate"). If you send one, or the workflow already has one from the dashboard, we answer 400: “This workflow has a step that turns DND off. Remove that step in the dashboard first.” A step can turn DND on.
• Lead Connector. The step that changes a contact in Lead Connector is updateLeadConnectorContact.

curl -X PUT "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Send new leads to my CRM",
    "nodes": [
      { "id": "start", "type": "contactCreated", "parentId": null, "config": {} },
      {
        "id": "crm",
        "type": "sendWebhook",
        "parentId": "start",
        "config": {
          "url": "https://crm.example.com/leads",
          "method": "POST",
          "headers": { "Authorization": "Bearer YOUR_CRM_TOKEN" }
        }
      }
    ]
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "name": "Send new leads to my CRM",
  "isPublished": true,
  "isActive": true,
  "version": 1,
  "publishedAt": "2026-10-11T09:00:00Z",
  "createdAt": "2026-10-10T09:00:00Z",
  "updatedAt": "2026-10-11T10:00:00Z",
  "nodes": [
    { "id": "start", "type": "contactCreated", "parentId": null, "pathId": null, "config": {}, "position": { "x": 0, "y": 0 } },
    {
      "id": "crm",
      "type": "sendWebhook",
      "parentId": "start",
      "pathId": null,
      "config": { "url": "https://crm.example.com/leads", "method": "POST", "headerNames": ["Authorization"] },
      "position": { "x": 0, "y": 0 }
    }
  ]
}

​

Errors