Campaign Agent Templates

Templates define a campaign's starting shape - its fields, default criteria, and channel content - so a new campaign doesn't start from a blank page. Rather than generic defaults, templates are generated by Bud's Segment and Campaign agents: they take in your organisation's context and goals, understand your data, and surface relevant campaign ideas - including previously untapped customer segments worth reaching out to - as ready-to-use templates. Bud manages template creation and updates internally (both manually and, increasingly, agentically), so this API is read and delete only; there's no endpoint to create or edit a template directly.

Retrieve available templates

GET /drive-api/v1/campaign-templates/compiled-templates

Returns the merged set of base and client-specific templates enabled for your organisation:

{
  "data": {
    "templates": [
      {
        "template_id": "89d133a9-02f8-4217-adb8-1d341fc91101",
        "source": { "type": "manual", "metadata": {} },
        "campaign_fields": {
          "name": "Campaign Name",
          "description": "A description of the purpose of the campaign"
        },
        "criteria": {
          "operator": "logical_and",
          "operands": [
            { "criteria": "flag", "name": "insight_name" },
            { "operator": "logical_not", "operands": [{ "criteria": "flag", "name": "other_insight" }] }
          ]
        }
      }
    ]
  }
}

An empty templates array (still a 200, not a 404) just means nothing's configured yet for your organisation. Use a template's template_id when creating a campaign.

Removing a client-specific template

DELETE /drive-api/v1/campaign-templates/templates/{template_id}

This only removes your organisation's own override of a template - it doesn't touch a shared base template, and it's safe to call even if the ID no longer exists.