Lead Follow-ups

Follow-ups are timed re-engagement messages that fire after a lead is classified. Each step is { delay, prompt, active }: delay is the number of seconds from the moment of classification, prompt is the instruction the AI uses to write the message, and active toggles the step.

A follow-up step belongs either to a specific category or to the org-wide default set, which applies to categories that have no steps of their own. Follow-ups are managed as a whole list per target (replace the array), which keeps ordering predictable.

List all follow-ups

GET/v2.0/leads/followups

The org-wide default set plus every category's own steps.

curl -X GET "https://api.sendiee.com/v2.0/leads/followups" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": {
    "default": [
      {
        "delay": 3600,
        "prompt": "Re-engage the customer.",
        "active": true
      }
    ],
    "categories": [
      {
        "name": "Hot Lead",
        "fuDisabled": false,
        "followups": [
          {
            "delay": 600,
            "prompt": "Nudge to checkout.",
            "active": true
          }
        ]
      }
    ]
  }
}
Try it — API Playground

Replace a category's follow-ups

PUT/v2.0/leads/categories/{name}/followups

Replaces the named category's follow-up steps with the array you send. Pass an empty array to clear them.

Body

ParameterTypeDescription
followupsobject[]{ delay: number(seconds), prompt: string, active?: boolean }[]
cURL
curl -X PUT "https://api.sendiee.com/v2.0/leads/categories/Hot%20Lead/followups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "followups": [
    { "delay": 600,  "prompt": "Nudge them to complete the purchase.", "active": true },
    { "delay": 3600, "prompt": "Offer help with checkout.", "active": true }
  ] }'
{
  "success": true,
  "data": {
    "name": "Hot Lead",
    "followups": [
      {
        "delay": 600,
        "prompt": "Nudge…",
        "active": true
      }
    ]
  }
}

Replace the default follow-ups

PUT/v2.0/leads/followups/default

Replaces the org-wide default set used by categories without their own steps.

Body

ParameterTypeDescription
followupsobject[]{ delay, prompt, active }[]
cURL
curl -X PUT "https://api.sendiee.com/v2.0/leads/followups/default" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "followups": [ { "delay": 3600, "prompt": "Re-engage the customer.", "active": true } ] }'
{
  "success": true,
  "data": {
    "default": [
      {
        "delay": 3600,
        "prompt": "Re-engage…",
        "active": true
      }
    ]
  }
}