Skip to main content
POST
Create a motion

Authorizations

api_key
string
header
required

Body

application/json
name
string
required

Motion name

offeringId
string
required

Offering oId (product or service)

motionType
enum<string>
required

Motion type

Available options:
NET_NEW,
UPSELL,
CROSS_SELL,
CONVERT_FREE_TO_PAID,
RENEW_AND_RETAIN,
DISPLACE_INCUMBENT
data
object
required

Motion configuration data. Target-ICP exclusions are set via the top-level excludedPersonaOIds/excludedSegmentOIds fields, not here.

description
string

Motion description

srcOfferingId
string

Optional source/FROM offering oId (cross-sell, convert-free-to-paid).

competitorOId
string

Optional competitor oId being displaced (displace-incumbent).

coreFeatureOIds
string[]

Optional core-feature oIds to emphasize.

excludedPersonaOIds
string[]

Persona oIds to exclude from the motion's target ICP. Excluded personas still get matrix cells, but disabled. Must be linked to the offering.

Maximum array length: 1000
excludedSegmentOIds
string[]

Segment oIds to exclude from the motion's target ICP. Excluded segments still get matrix cells, but disabled. Must be linked to the offering.

Maximum array length: 1000

Response

Created motion

_metadata
object
required
data
object
required