Skip to main content

​
What is a Motion?

A Motion is a complete go-to-market strategy in the Octave Library — the unit your team actually executes against. It binds an offering to a market motion type (new business, expansion, renewal, displacement), a set of narrative angles (Motion Playbooks), and the persona×segment cells that detail who you’re selling to and how (Motion ICPs). When an agent generates an email, qualifies an account, or preps a call, it traverses the Motion to read the right narrative for the right audience — grounded in your strategy, not generic templates. Motions replace the legacy Playbook entity. Where a legacy Playbook was a single flat object, a Motion is a structured hierarchy: one Motion → many Motion Playbooks (narrative angles) → many Motion ICPs (persona×segment cells). Each layer is independently editable, learnable, and addressable by agents and the API.

​
What a Motion contains

​
Motion Playbooks

A Motion Playbook is a narrative angle within a Motion — a specific way of framing the same offering to a specific audience or moment. A single Motion typically contains several Motion Playbooks, each with its own narrative type:
DEFAULT is set automatically on the playbook created with each Motion and isn’t a user-creatable type — when calling POST /api/v2/motion-playbook/create, the narrativeType enum is restricted to THEMATIC, MILESTONE, ACCOUNT, or COMPETITIVE.
A Motion Playbook owns the messaging that agents actually deploy:

​
Motion ICPs

A Motion ICP is the intersection of one persona and one segment inside a Motion Playbook’s scope — the smallest addressable cell in the strategy. Each Motion ICP holds the narrative, learnings, and recommended library elements for that exact persona×segment cell.

​
Narrative

Each Motion ICP carries a structured narrative the agents read:
  • Target ICP overview — who this cell is
  • Operating landscape — the world they live in
  • Strategic narrative — the story you’re telling them
  • Pains and consequences — what hurts if they don’t act
  • Benefits and impacts — what changes if they do
  • Methodology — the structured discovery / qualification path
  • References — the relevant customer stories to cite

​
Learnings

Octave continuously generates learnings on each Motion ICP from real conversations: Each learning carries a confidence score, a source (AI_GENERATED or USER_DEFINED), evidence counts per channel, and a pin status so your team can lock in the ones that matter. Learnings flow from the analytics pipeline directly into the Motion ICP that produced them. Octave recommends which existing Library entities to attach to a Motion ICP — use cases, proof points, references, competitors, alternatives, buying triggers, and objections. The agent uses these recommendations at runtime so the right evidence shows up for the right cell.

​
How agents use Motions

When you run an agent — a Sequence Agent, Call Prep Agent, or Qualify Person Agent — it identifies which Motion applies based on the offering and the prospect’s persona and segment. It then selects the right Motion Playbook (default, competitive, account-specific, etc.), and from there reads the Motion ICP narrative, learnings, and recommended elements for that persona×segment cell. The same agent produces dramatically different output for an Enterprise CFO in healthcare and a mid-market SDR Manager in fintech, because the Motion routes each prospect to a different cell.

​
Managing Motions via API

  • GET /api/v2/motion/list — list motions
  • GET /api/v2/motion/get — get a motion with its default playbook
  • POST /api/v2/motion/create — create a motion (and its default playbook)
  • POST /api/v2/motion/update — update a motion
  • DELETE /api/v2/motion/delete — delete a motion
  • GET /api/v2/motion-playbook/list / get / POST create / POST update / DELETE delete — manage Motion Playbooks
  • GET /api/v2/motion-icp/list — list Motion ICP cells under a playbook
  • GET /api/v2/motion-icp/get — get the full Motion ICP detail (narrative + status)
  • GET /api/v2/motion-icp/elements/list — list recommended library elements for a Motion ICP
  • GET /api/v2/motion-icp/learnings/list — list learnings for a Motion ICP
  • GET /api/v2/motion-icp/learnings/get — get a single learning