Create a fully-configured play in one call: the product (an existing productId, or a websiteUrl which seeds one and kicks its research), the play itself, the ICP facets, which sourcing lanes are on, the autonomy ladder and the caps. Three rules are enforced server-side and cannot be talked around. (1) `activate` DEFAULTS TO FALSE — turning a play on spends the month's lead quota and takes real actions from the user's own LinkedIn account, so hand the human the returned cockpit link and let them press go. (2) A play with no live LinkedIn seat stays a draft whatever you pass. (3) Autonomy rules are written ONLY for the steps you name; every step you omit keeps gtmotto's own default, which is 'wait for a human'. Lanes that need their own seeds (post_engagers, competitor_posts, account_list) are refused if switched on without them.
View input schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The play's name."
},
"productId": {
"type": "string",
"description": "An existing product. Omit to create one."
},
"websiteUrl": {
"type": "string",
"description": "Seeds a NEW product from this website and kicks its research."
},
"productName": {
"type": "string",
"description": "Defaults to the website's hostname."
},
"goal": {
"type": "string",
"description": "What a conversation from this play should reach."
},
"voice": {
"type": "string",
"description": "How the messages should sound."
},
"icp": {
"type": "object",
"properties": {
"titles": {
"type": "array",
"items": {
"type": "string"
}
},
"seniority": {
"type": "array",
"items": {
"type": "string"
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"industries": {
"type": "array",
"items": {
"type": "string"
}
},
"sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"exclude": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false,
"description": "The audience, as plain strings — the same seven fields the cockpit's ICP screen fills. gtmotto compiles them into a LinkedIn search and normalises odd labels itself ('Swiss' → Switzerland, 'Fintech' → Financial Services)."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"enum": [
"people_search",
"competitor_posts",
"job_offers",
"account_list",
"post_engagers"
],
"description": "people_search: LinkedIn people search compiled from the play's ICP (+ optional free-text keywords). | competitor_posts: Post discovery: Otto searches LinkedIn daily for posts matching an intent, judges each, and takes who engaged. | job_offers: Hiring signal: companies posting a role → the buyers inside them. | account_list: Companies you name (names, websites or LinkedIn page URLs) → Otto finds your buyers inside each. | post_engagers: RETIRED — folded into competitor_posts.postUrls. Still runs on rows that exist; do not configure it on new plays."
},
"on": {
"type": "boolean"
},
"config": {
"type": "object",
"properties": {
"keywords": {
"type": "string",
"description": "people_search: extra free-text terms on top of the ICP query (alone, a complete search). job_offers: the role being hired, e.g. 'Head of Sales'."
},
"intent": {
"type": "string",
"maxLength": 1000,
"description": "competitor_posts only. What you are hunting, in the operator's own words and language — e.g. 'people struggling with manual LinkedIn prospecting'. Drives the search writer, the post scorer and the comment scorer."
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"description": "competitor_posts only. Keyword ANCHORS — tools, brands, chores ('Sales Navigator', 'Waalaxy', 'prospects froids'). The fallback searches when no intent is set. Max 25."
},
"postUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "competitor_posts (and retired post_engagers): LinkedIn post URLs or urn:li:activity:… URNs to harvest as they are. Max 25."
},
"companies": {
"type": "array",
"items": {
"type": "string"
},
"description": "account_list only. One entry per company — a name ('Acme'), a website ('acme.io') or a LinkedIn page URL ('linkedin.com/company/acme-corp'). Max 100."
},
"commenters": {
"type": "boolean",
"description": "Post lanes: take the people who commented (default true)."
},
"reactors": {
"type": "boolean",
"description": "Post lanes: take the people who reacted (default true). Both off = refused."
},
"minReactions": {
"type": [
"number",
"null"
],
"description": "competitor_posts: reaction floor for FOUND posts ('skip the posts nobody saw'); null = any post. The UI offers 25/50/100/250."
},
"postedWithinDays": {
"type": [
"number",
"null"
],
"description": "job_offers: how fresh the posting must be, in days; null = any."
},
"postGate": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
],
"description": "competitor_posts: post-relevance floor 0–100, or null for OFF (the default). 0 is not off — it still demands a model verdict."
},
"intentGate": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
],
"description": "Post lanes: per-person intent (scored from their comment against `intent`) floor 0–100, or null for OFF (the default). 0 is not off — it still demands a model verdict."
},
"fitGate": {
"type": "string",
"enum": [
"strict",
"standard",
"loose",
"off"
],
"description": "How the ICP facets LinkedIn could not filter on are judged per person: strict = every unmapped facet must match; standard (default) = one match is enough; loose = role/seniority only (best for engager lanes); off = keep everyone the query returned. The ICP's `exclude` list is absolute at every level."
}
},
"additionalProperties": false
}
},
"required": [
"key"
],
"additionalProperties": false
},
"description": "The sourcing lanes to configure."
},
"autonomy": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"enum": [
"visit",
"like",
"comment",
"invite",
"first_dm",
"follow_up",
"reply"
]
},
"auto": {
"type": "boolean"
}
},
"required": [
"key",
"auto"
],
"additionalProperties": false
},
"description": "Only the rungs you name are written. Omitted rungs wait for a human."
},
"dailyCap": {
"type": "number",
"description": "Actions per day, all kinds summed. Defaults to the seat's full LinkedIn allowance (145), so pass it only to throttle. ACCOUNT-level: sets the ceiling every play on this LinkedIn account shares, not a per-play budget."
},
"workingHours": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"end": {
"type": "string"
},
"tz": {
"type": "string"
}
},
"required": [
"start",
"end",
"tz"
],
"additionalProperties": false,
"description": "e.g. { start: '09:00', end: '18:00', tz: 'Europe/Paris' }. ACCOUNT-level, like dailyCap."
},
"activate": {
"type": "boolean",
"description": "Default false. True only starts it if a live seat is already connected."
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}