Skip to main content
DELETE
/
v1
/
campaigns
/
{id}
/
steps
/
{stepId}
Delete Step
curl --request DELETE \
  --url https://app-api.walead.ai/api/v1/campaigns/{id}/steps/{stepId} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "steps": [
    {
      "id": "<string>",
      "type": "invitation",
      "order": 123,
      "delay": 123,
      "stopOnReply": true,
      "genericBody": "<string>",
      "variants": [
        {
          "id": "<string>",
          "body": "<string>",
          "order": 123,
          "isDisabled": true,
          "icpDefinitionRaw": "<string>",
          "stepId": "<string>",
          "aiTools": [
            {
              "name": "<string>",
              "key": "<string>"
            }
          ]
        }
      ]
    }
  ]
}

​
Overview

Removes a step from your campaign sequence. This is a destructive action that cannot be undone, so use with caution.

​
What Happens When You Delete a Step

  1. Step is removed: The step and all its variants are permanently deleted
  2. Sequence is reordered: Steps after the deleted one move up in order
  3. Leads are adjusted: Leads already in the campaign have their progress updated
  4. Completed leads checked: If leads had completed the campaign, they may be reset if the deletion creates new steps to execute

​
Impact on Active Campaigns

If you delete a step from an active campaign:
  • Leads who haven’t reached this step will skip it
  • Leads currently at this step will move to the next one
  • Leads who have passed this step are unaffected (unless they were marked as completed)

​
Response

Returns the updated array of steps after deletion, reflecting the new sequence order.

​
Important Notes

Deleting a step cannot be undone. Consider pausing the campaign first if you’re testing sequence changes.
If you want to temporarily disable a step, consider disabling all its variants instead of deleting the entire step.

​
Before Deleting

Consider:
  • Are there leads currently at this step?
  • Do you want to preserve the message templates for future use?
  • Would pausing or disabling variants be a better option?

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
id
string
required

Campaign ID

​
stepId
string
required

Step ID

Response

Step deleted successfully

​
success
boolean
​
message
string
​
steps
object[]