AI that makes and runs your Google and Facebook ads from your own account, with a CRM behind it.
Inferido de los transportes que declara este listado (streamable-http). Que un cliente no aparezca aquí no significa que se haya descartado: simplemente Forge no puede confirmarlo.
La verificación confirma la identidad del publicador (la propiedad del repo), no la seguridad del código. El análisis de seguridad cubre los CVE conocidos y los scripts de instalación sospechosos.
Leído de un handshake MCP real initialize → tools/list contra el endpoint declarado. No se invocó ninguna herramienta: tools/list es la llamada de introspección de solo lectura que el protocolo define para esto. Refleja lo que el servidor anunciaba en ese momento; un endpoint alojado no está fijado a ninguna versión y puede cambiar sin avisar.
https://plyto.ai/api/mcp172 herramientas · 1113 msmemory__saveSave (or update) a durable memory: a standing preference, playbook rule, correction, or business fact that should hold across ALL future conversations. Use when the user says "remember…", "always…", "never…", "from now on…", states a lasting preference, or corrects how you did something. One distil…Save (or update) a durable memory: a standing preference, playbook rule, correction, or business fact that should hold across ALL future conversations. Use when the user says "remember…", "always…", "never…", "from now on…", states a lasting preference, or corrects how you did something. One distil…
| Parámetro | Tipo | Descripción |
|---|---|---|
| content* | string | The rule itself, self-contained and imperative. |
| kind* | string | preference = how they like things done; fact = stable business fact; playbook = how to run a recurring task; correction = a fix after you got something wrong. |
| scope | string | business (default) = applies to everyone; personal = only the current user's own preference (e.g. how THEY want summaries). |
| source | string | user_told (default) = the user explicitly said it; learned = you inferred it from a correction or repeated behavior. |
| memoryId | string | Update this existing memory instead of creating a new one. |
memory__listList every durable memory you hold for this business (business-wide plus the current user's personal ones), with ids and when each was last confirmed. Use before consolidating, when the user asks what you remember, or to find a memoryId to update/forget.List every durable memory you hold for this business (business-wide plus the current user's personal ones), with ids and when each was last confirmed. Use before consolidating, when the user asks what you remember, or to find a memoryId to update/forget.
No se publicó ningún esquema de entrada para esta herramienta.
memory__forgetPermanently delete a saved memory. Destructive: confirm with the user first unless they just explicitly asked you to forget exactly this. Users can also remove memories themselves under Settings → Business profile.Permanently delete a saved memory. Destructive: confirm with the user first unless they just explicitly asked you to forget exactly this. Users can also remove memories themselves under Settings → Business profile.
| Parámetro | Tipo | Descripción |
|---|---|---|
| memoryId* | string | — |
business__updateSave what you learn about the business the moment the owner says it: real name, website, industry, who their customers are, what sets them apart, the phone to show on pages, where an ad's click should go (clickTarget page or url, and conversionUrl: their signup, booking or checkout link), and durab…Save what you learn about the business the moment the owner says it: real name, website, industry, who their customers are, what sets them apart, the phone to show on pages, where an ad's click should go (clickTarget page or url, and conversionUrl: their signup, booking or checkout link), and durab…
websiteUrl: Links to undeclared domain: | Parámetro | Tipo | Descripción |
|---|---|---|
| name | string | The business's real name, exactly as the owner gave it. |
| websiteUrl | string | Their website, with or without https://. |
| industry | string | What kind of business, in their words: 'mobile dog grooming', 'roofing contractor', 'boutique fitness studio'. |
| audience | string | Who they sell to, as they described it: 'homeowners in Austin with dogs', 'B2B SaaS founders under 20 employees'. |
| valueProp | string | What sets them apart, in one or two sentences, from the owner's own words. |
| addClaims | array | Durable facts the owner just stated that copy may rely on, one per entry, in their words: an offer ('Free roof inspections'), a price ('Shingle repair from $35… |
| contactPhone | string | The phone number pages and landing pages should show, as the owner gave it. |
| clickTarget | string | Where an ad's click goes, only as the OWNER answered it (prefer ads.destination.set, which also builds the page or points the ads). page: Plyto builds a landin… |
| conversionUrl | string | Their own signup, booking, checkout or landing page link, as the owner gave it. Pass an empty string to clear it. |
crm__contacts__createCreate a contact (or find-and-update if one with the same email already exists in this business). Returns the created/updated contact. Use when the user mentions adding, capturing, or tracking a new person. Email is the natural dedup key; if you have an email, always pass it.Create a contact (or find-and-update if one with the same email already exists in this business). Returns the created/updated contact. Use when the user mentions adding, capturing, or tracking a new person. Email is the natural dedup key; if you have an email, always pass it.
| Parámetro | Tipo | Descripción |
|---|---|---|
| string | Primary email, used as dedup key. | |
| firstName | string | — |
| lastName | string | — |
| phone | string | — |
| companyId | string | Existing company id to link this contact to. |
| title | string | — |
| lifecycleStage | string | — |
| leadStatus | string | — |
| source | string | Where this contact came from: 'manual', 'import', 'form', 'ad', etc. |
| sourceDetail | string | — |
crm__contacts__updateUpdate fields on an existing contact. Only pass fields you want to change. No-op fields are silently skipped.Update fields on an existing contact. Only pass fields you want to change. No-op fields are silently skipped.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
| — | — | |
| firstName | — | — |
| lastName | — | — |
| phone | — | — |
| companyId | — | — |
| title | — | — |
| lifecycleStage | string | — |
| leadStatus | — | — |
| ownerUserId | — | — |
crm__contacts__getFetch a single contact by id, with where they came from: the ad campaign and search keyword that brought them (when an ad did), where they were and on what device, what they asked for on the landing page, how many forms they submitted, and whether they have created an account. Use this, not source_…Fetch a single contact by id, with where they came from: the ad campaign and search keyword that brought them (when an ad did), where they were and on what device, what they asked for on the landing page, how many forms they submitted, and whether they have created an account. Use this, not source_…
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
crm__contacts__listList contacts in this business with simple filters. For free-text search use crm.contacts.search. For complex filters use crm.contacts.query (W3).List contacts in this business with simple filters. For free-text search use crm.contacts.search. For complex filters use crm.contacts.query (W3).
| Parámetro | Tipo | Descripción |
|---|---|---|
| limit | integer | — |
| offset | integer | — |
| ownerUserId | string | — |
| lifecycleStage | string | — |
| hasEmail | boolean | — |
crm__contacts__searchFree-text search across contact email, first/last name, and phone. Case-insensitive substring match. Returns up to 20 contacts by default.Free-text search across contact email, first/last name, and phone. Case-insensitive substring match. Returns up to 20 contacts by default.
| Parámetro | Tipo | Descripción |
|---|---|---|
| query* | string | — |
| limit | integer | — |
crm__contacts__get_propertiesReturn all custom property values for a contact as a {key: value} map.Return all custom property values for a contact as a {key: value} map.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
crm__companies__createCreate a company (or find-and-update if one with the same domain already exists). Domain is the natural dedup key; always pass the bare domain like 'acme.com' (not the full URL).Create a company (or find-and-update if one with the same domain already exists). Domain is the natural dedup key; always pass the bare domain like 'acme.com' (not the full URL).
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| domain | string | — |
| industry | string | — |
| size | string | — |
| annualRevenueCents | integer | — |
| description | string | — |
crm__companies__updateUpdate fields on an existing company. Only pass fields you want to change.Update fields on an existing company. Only pass fields you want to change.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
| name | string | — |
| domain | — | — |
| industry | — | — |
| size | — | — |
| annualRevenueCents | — | — |
| description | — | — |
| ownerUserId | — | — |
crm__companies__getFetch a single company by id. Returns null if not found.Fetch a single company by id. Returns null if not found.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
crm__companies__listList companies in this business. For text search use crm.companies.search.List companies in this business. For text search use crm.companies.search.
| Parámetro | Tipo | Descripción |
|---|---|---|
| limit | integer | — |
| offset | integer | — |
| ownerUserId | string | — |
crm__companies__searchFree-text search across company name, domain, and industry. Case-insensitive substring match.Free-text search across company name, domain, and industry. Case-insensitive substring match.
| Parámetro | Tipo | Descripción |
|---|---|---|
| query* | string | — |
| limit | integer | — |
crm__companies__get_propertiesReturn all custom property values for a company as a {key: value} map.Return all custom property values for a company as a {key: value} map.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
crm__tags__createCreate a new tag (or find one with the same name; idempotent). Tags are lightweight orthogonal categories like 'VIP', 'Newsletter-only', 'Cold'.Create a new tag (or find one with the same name; idempotent). Tags are lightweight orthogonal categories like 'VIP', 'Newsletter-only', 'Cold'.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| color | string | — |
crm__tags__listList all tags defined in this business.List all tags defined in this business.
No se publicó ningún esquema de entrada para esta herramienta.
crm__tags__add_to_contactApply a tag to a contact. Idempotent: adding an already-applied tag is a no-op.Apply a tag to a contact. Idempotent: adding an already-applied tag is a no-op.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
| tagId* | string | — |
crm__tags__remove_from_contactprivilegiadaRemove a tag from a contact. Idempotent.Remove a tag from a contact. Idempotent.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
| tagId* | string | — |
crm__tags__list_for_contactList all tags applied to a contact.List all tags applied to a contact.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
crm__tags__add_to_companyApply a tag to a company. Idempotent.Apply a tag to a company. Idempotent.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
| tagId* | string | — |
crm__tags__remove_from_companyprivilegiadaRemove a tag from a company. Idempotent.Remove a tag from a company. Idempotent.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
| tagId* | string | — |
crm__tags__list_for_companyList all tags applied to a company.List all tags applied to a company.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
crm__properties__defineDefine a new custom property on contact or company. Keys must be lowercase snake_case (e.g. 'plan_tier'). For single_select / multi_select, options is required.Define a new custom property on contact or company. Keys must be lowercase snake_case (e.g. 'plan_tier'). For single_select / multi_select, options is required.
| Parámetro | Tipo | Descripción |
|---|---|---|
| entityType* | string | — |
| key* | string | — |
| label* | string | — |
| propertyType* | string | — |
| options | array | — |
| isRequired | boolean | — |
| displayOrder | integer | — |
| description | string | — |
crm__properties__listList custom property definitions for an entity type. Excludes archived by default.List custom property definitions for an entity type. Excludes archived by default.
| Parámetro | Tipo | Descripción |
|---|---|---|
| entityType* | string | — |
| includeArchived | boolean | — |
crm__properties__archiveArchive a custom property. Existing values are preserved but the property is hidden from UI and rejected for new value sets. To 'rename', archive + redefine.Archive a custom property. Existing values are preserved but the property is hidden from UI and rejected for new value sets. To 'rename', archive + redefine.
| Parámetro | Tipo | Descripción |
|---|---|---|
| propertyDefinitionId* | string | — |
crm__properties__set_contact_valueSet the value of a custom property on a contact. Value type must match property type. For multi_select pass an array of option values.Set the value of a custom property on a contact. Value type must match property type. For multi_select pass an array of option values.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
| propertyDefinitionId* | string | — |
| value* | — | — |
crm__properties__set_company_valueSet the value of a custom property on a company.Set the value of a custom property on a company.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
| propertyDefinitionId* | string | — |
| value* | — | — |
crm__properties__set_deal_valueSet the value of a custom property on a deal.Set the value of a custom property on a deal.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
| propertyDefinitionId* | string | — |
| value* | — | — |
crm__properties__clear_contact_valueRemove a custom property value from a contact.Remove a custom property value from a contact.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId* | string | — |
| propertyDefinitionId* | string | — |
crm__properties__clear_company_valueRemove a custom property value from a company.Remove a custom property value from a company.
| Parámetro | Tipo | Descripción |
|---|---|---|
| companyId* | string | — |
| propertyDefinitionId* | string | — |
crm__properties__clear_deal_valueRemove a custom property value from a deal.Remove a custom property value from a deal.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
| propertyDefinitionId* | string | — |
crm__properties__get_deal_valuesReturn all custom property values for a deal as a {key: value} map.Return all custom property values for a deal as a {key: value} map.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
crm__pipelines__listList all pipelines in this business (excludes archived by default).List all pipelines in this business (excludes archived by default).
| Parámetro | Tipo | Descripción |
|---|---|---|
| includeArchived | boolean | — |
crm__pipelines__list_stagesList the ordered stages in a pipeline. Use to look up stageIds for crm.deals.move_stage.List the ordered stages in a pipeline. Use to look up stageIds for crm.deals.move_stage.
| Parámetro | Tipo | Descripción |
|---|---|---|
| pipelineId* | string | — |
crm__pipelines__get_defaultGet the default pipeline for this business (the one new deals land in by default). Returns null if no default is set.Get the default pipeline for this business (the one new deals land in by default). Returns null if no default is set.
No se publicó ningún esquema de entrada para esta herramienta.
crm__deals__createCreate a deal in a pipeline. If pipelineId/stageId omitted, lands in the business's default pipeline at the first open stage. Attach to a contact and/or company for full context. valueCents is the deal size in cents (e.g. $5,000 = 500000).Create a deal in a pipeline. If pipelineId/stageId omitted, lands in the business's default pipeline at the first open stage. Attach to a contact and/or company for full context. valueCents is the deal size in cents (e.g. $5,000 = 500000).
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| pipelineId | string | — |
| stageId | string | — |
| contactId | string | — |
| companyId | string | — |
| valueCents | integer | — |
| currency | string | ISO 4217 code, default USD. |
| expectedCloseAt | string | ISO 8601 timestamp. |
| ownerUserId | string | — |
| source | string | — |
crm__deals__updateUpdate fields on a deal. Use crm.deals.move_stage to change stage (it handles close events). Use crm.deals.close_won / close_lost for the won/lost transitions.Update fields on a deal. Use crm.deals.move_stage to change stage (it handles close events). Use crm.deals.close_won / close_lost for the won/lost transitions.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
| name | string | — |
| contactId | — | — |
| companyId | — | — |
| valueCents | — | — |
| currency | string | — |
| expectedCloseAt | — | — |
| ownerUserId | — | — |
| source | — | — |
crm__deals__move_stageprivilegiadaMove a deal to a different stage in the same pipeline. If the target stage is a won/lost stage, this auto-sets closedAt and emits the appropriate close event.Move a deal to a different stage in the same pipeline. If the target stage is a won/lost stage, this auto-sets closedAt and emits the appropriate close event.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
| targetStageId* | string | — |
crm__deals__close_wonClose a deal as won: moves it to the won stage in its pipeline. Sets closedAt and emits deal.won.Close a deal as won: moves it to the won stage in its pipeline. Sets closedAt and emits deal.won.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
crm__deals__close_lostClose a deal as lost: moves it to the lost stage in its pipeline. Records lostReason and emits deal.lost.Close a deal as lost: moves it to the lost stage in its pipeline. Records lostReason and emits deal.lost.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
| reason | string | — |
crm__deals__getFetch a single deal by id.Fetch a single deal by id.
| Parámetro | Tipo | Descripción |
|---|---|---|
| dealId* | string | — |
crm__deals__listList deals with simple filters. Filter by pipeline/stage for Kanban view, or by contact/company for deal history. `open: true` returns only open-stage deals; omit for all.List deals with simple filters. Filter by pipeline/stage for Kanban view, or by contact/company for deal history. `open: true` returns only open-stage deals; omit for all.
| Parámetro | Tipo | Descripción |
|---|---|---|
| pipelineId | string | — |
| stageId | string | — |
| ownerUserId | string | — |
| contactId | string | — |
| companyId | string | — |
| open | boolean | — |
| limit | integer | — |
crm__deals__searchFree-text search across deal names.Free-text search across deal names.
| Parámetro | Tipo | Descripción |
|---|---|---|
| query* | string | — |
| limit | integer | — |
crm__activities__logLog an activity: something that happened (past or scheduled). Distinguished from tasks (future intent) and notes (no structure). Use 'log a 30-min discovery call with Jane' style prompts. happenedAt defaults to now if omitted.Log an activity: something that happened (past or scheduled). Distinguished from tasks (future intent) and notes (no structure). Use 'log a 30-min discovery call with Jane' style prompts. happenedAt defaults to now if omitted.
| Parámetro | Tipo | Descripción |
|---|---|---|
| type* | string | — |
| title* | string | — |
| body | string | — |
| happenedAt | string | ISO 8601. Default: now. |
| durationMinutes | integer | — |
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
| ownerUserId | string | — |
crm__activities__listList activities, optionally filtered by entity (contact/company/deal) or owner. Returned in reverse chronological order by happenedAt.List activities, optionally filtered by entity (contact/company/deal) or owner. Returned in reverse chronological order by happenedAt.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
| ownerUserId | string | — |
| type | string | — |
| limit | integer | — |
crm__activities__getFetch a single activity by id.Fetch a single activity by id.
| Parámetro | Tipo | Descripción |
|---|---|---|
| activityId* | string | — |
crm__tasks__createCreate a task: future intent ('follow up with Acme by Friday'). Distinguished from activities (past event) and notes (no structure). Auto-assigns to the calling user if assignedToUserId omitted.Create a task: future intent ('follow up with Acme by Friday'). Distinguished from activities (past event) and notes (no structure). Auto-assigns to the calling user if assignedToUserId omitted.
| Parámetro | Tipo | Descripción |
|---|---|---|
| title* | string | — |
| description | string | — |
| dueAt | string | ISO 8601 timestamp. |
| priority | string | — |
| assignedToUserId | string | — |
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
crm__tasks__completeMark a task as completed. Sets completedAt to now.Mark a task as completed. Sets completedAt to now.
| Parámetro | Tipo | Descripción |
|---|---|---|
| taskId* | string | — |
crm__tasks__cancelMark a task as cancelled (rejected, different from completed). Use when the user decides a task is no longer relevant.Mark a task as cancelled (rejected, different from completed). Use when the user decides a task is no longer relevant.
| Parámetro | Tipo | Descripción |
|---|---|---|
| taskId* | string | — |
crm__tasks__listList tasks. Open tasks sort by due date (closest first). Completed tasks sort by completion (most recent first).List tasks. Open tasks sort by due date (closest first). Completed tasks sort by completion (most recent first).
| Parámetro | Tipo | Descripción |
|---|---|---|
| assignedToUserId | string | — |
| status | string | — |
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
| limit | integer | — |
crm__tasks__getFetch a single task by id.Fetch a single task by id.
| Parámetro | Tipo | Descripción |
|---|---|---|
| taskId* | string | — |
reports__previewRun a report config WITHOUT saving. Use it to answer analytical questions ('deals by stage', 'contacts added per month', 'email opens last 30 days') and to sanity-check a config before reports.create. Returns rows + totals. Money values are in cents.Run a report config WITHOUT saving. Use it to answer analytical questions ('deals by stage', 'contacts added per month', 'email opens last 30 days') and to sanity-check a config before reports.create. Returns rows + totals. Money values are in cents.
| Parámetro | Tipo | Descripción |
|---|---|---|
| config* | object | — |
crm__sources__performanceMarketing-source attribution: for every source (ad campaigns, UTM-tagged traffic, forms, inbound webhook, manual, import…; the webhook also accepts POST {email, outcome: qualified|customer} at /outcome so an external system of record can report when a lead pays) the full funnel (leads acquired, dea…Marketing-source attribution: for every source (ad campaigns, UTM-tagged traffic, forms, inbound webhook, manual, import…; the webhook also accepts POST {email, outcome: qualified|customer} at /outcome so an external system of record can report when a lead pays) the full funnel (leads acquired, dea…
| Parámetro | Tipo | Descripción |
|---|---|---|
| windowDays | integer | Look-back window in days; each funnel stage is windowed independently (leads created / deals opened / deals won inside it). Default 90. |
reports__createSave a custom report as a live card on the user's Reports dashboard. Use when the user asks for a report or says yes to saving an analysis. The config is re-executed on every dashboard view (always live). Validates by running once; returns the saved report + current data.Save a custom report as a live card on the user's Reports dashboard. Use when the user asks for a report or says yes to saving an analysis. The config is re-executed on every dashboard view (always live). Validates by running once; returns the saved report + current data.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | Card title, e.g. 'Deals won by month' |
| description | string | — |
| config* | object | — |
reports__listList the saved custom reports on the Reports dashboard.List the saved custom reports on the Reports dashboard.
No se publicó ningún esquema de entrada para esta herramienta.
crm__notes__addAdd a freeform note attached to a contact, company, deal, or any combination. Use for 'remember that Jane prefers email over phone' style facts.Add a freeform note attached to a contact, company, deal, or any combination. Use for 'remember that Jane prefers email over phone' style facts.
| Parámetro | Tipo | Descripción |
|---|---|---|
| body* | string | — |
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
crm__notes__listList notes, optionally filtered by attached entity.List notes, optionally filtered by attached entity.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId | string | — |
| companyId | string | — |
| dealId | string | — |
| limit | integer | — |
crm__lists__createCreate a contact list. Manual lists are curated by hand; dynamic lists have a filter DSL (DNF: {or:[{and:[conditions]}]}) that defines membership. For dynamic, pass `criteria`. For manual, omit it.Create a contact list. Manual lists are curated by hand; dynamic lists have a filter DSL (DNF: {or:[{and:[conditions]}]}) that defines membership. For dynamic, pass `criteria`. For manual, omit it.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| type* | string | — |
| description | string | — |
| criteria | object | — |
crm__lists__getFetch a single list by id.Fetch a single list by id.
| Parámetro | Tipo | Descripción |
|---|---|---|
| listId* | string | — |
crm__lists__listList all contact lists in this business.List all contact lists in this business.
| Parámetro | Tipo | Descripción |
|---|---|---|
| includeArchived | boolean | — |
crm__lists__membersReturn the contacts that are members of a list. For manual lists this returns explicit memberships; for dynamic lists it evaluates the criteria filter against contacts (lazy recompute).Return the contacts that are members of a list. For manual lists this returns explicit memberships; for dynamic lists it evaluates the criteria filter against contacts (lazy recompute).
| Parámetro | Tipo | Descripción |
|---|---|---|
| listId* | string | — |
| limit | integer | — |
crm__lists__add_contactAdd a contact to a MANUAL list. Idempotent.Add a contact to a MANUAL list. Idempotent.
| Parámetro | Tipo | Descripción |
|---|---|---|
| listId* | string | — |
| contactId* | string | — |
crm__lists__remove_contactprivilegiadaRemove a contact from a manual list.Remove a contact from a manual list.
| Parámetro | Tipo | Descripción |
|---|---|---|
| listId* | string | — |
| contactId* | string | — |
crm__lists__archiveArchive a list. Membership rows are preserved but the list is hidden from default queries.Archive a list. Membership rows are preserved but the list is hidden from default queries.
| Parámetro | Tipo | Descripción |
|---|---|---|
| listId* | string | — |
forms__createCreate a form. Slug becomes the URL: /forms/<slug>. Fields are JSON-defined with type matching the contact property type system (text/email/url/number/date/checkbox/select/multi_select/textarea/phone). If captureToListId is set, every submission is auto-added to that list (use crm.lists.create firs…Create a form. Slug becomes the URL: /forms/<slug>. Fields are JSON-defined with type matching the contact property type system (text/email/url/number/date/checkbox/select/multi_select/textarea/phone). If captureToListId is set, every submission is auto-added to that list (use crm.lists.create firs…
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| slug* | string | — |
| fields* | array | — |
| theme | object | Per-form appearance; omitted values inherit the business brand |
| submitButtonText | string | — |
| thankYouMessage | string | — |
| thankYouRedirectUrl | string | — |
| captureToListId | string | — |
forms__updateUpdate a form: rename it, replace its fields, change appearance (theme), button text, thank-you behavior, or the capture list. Omitted properties keep their current value; `fields` and `theme` replace wholesale when provided, so send the COMPLETE new array/object (use forms.get first). Keep existin…Update a form: rename it, replace its fields, change appearance (theme), button text, thank-you behavior, or the capture list. Omitted properties keep their current value; `fields` and `theme` replace wholesale when provided, so send the COMPLETE new array/object (use forms.get first). Keep existin…
| Parámetro | Tipo | Descripción |
|---|---|---|
| formId* | string | — |
| name | string | — |
| fields | array | — |
| theme | — | Replaces the whole theme; null clears it back to brand defaults |
| submitButtonText | string | — |
| thankYouMessage | — | — |
| thankYouRedirectUrl | — | — |
| captureToListId | — | — |
forms__getFetch a form by id.Fetch a form by id.
| Parámetro | Tipo | Descripción |
|---|---|---|
| formId* | string | — |
forms__listList all forms in this business.List all forms in this business.
| Parámetro | Tipo | Descripción |
|---|---|---|
| includeArchived | boolean | — |
forms__list_submissionsList submissions for a form, newest first.List submissions for a form, newest first.
| Parámetro | Tipo | Descripción |
|---|---|---|
| formId* | string | — |
| limit | integer | — |
forms__get_embed_codeGenerate the JS embed snippet and iframe alternative for a form. Returns both; the user picks whichever fits their site.Generate the JS embed snippet and iframe alternative for a form. Returns both; the user picks whichever fits their site.
| Parámetro | Tipo | Descripción |
|---|---|---|
| formId* | string | — |
crm__contacts__queryQuery contacts with a structured filter DSL. Use this for complex 'show me contacts where X and Y but not Z' queries. Simpler cases prefer crm.contacts.search (free text) or crm.contacts.list (single filter).
Field reference forms:
email, firstName, ... = stock fields
custom:<key> = custom prope…Query contacts with a structured filter DSL. Use this for complex 'show me contacts where X and Y but not Z' queries. Simpler cases prefer crm.contacts.search (free text) or crm.contacts.list (single filter). Field reference forms: email, firstName, ... = stock fields custom:<key> = custom prope…
| Parámetro | Tipo | Descripción |
|---|---|---|
| filter* | object | — |
| limit | integer | — |
| offset | integer | — |
ads__campaign__draftCreate a draft ad campaign on Meta (Facebook and Instagram) or Google, the only two platforms Plyto can actually launch and manage. Drafts are NOT live: they require user approval and a UI launch action before spending money. Use when the user asks to create, generate, or set up a new ad campaign.Create a draft ad campaign on Meta (Facebook and Instagram) or Google, the only two platforms Plyto can actually launch and manage. Drafts are NOT live: they require user approval and a UI launch action before spending money. Use when the user asks to create, generate, or set up a new ad campaign.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | Campaign name shown in dashboards. |
| objective* | string | Campaign objective. OUTCOME_SALES is the typical default for paid conversion campaigns. |
| dailyBudgetCents* | integer | Daily budget in US cents (e.g. 5000 = $50/day). |
| audienceDescription | string | Who the ads should reach, in one or two plain sentences (the trade's customers, where they are, what they are dealing with); translated into platform targeting… |
| contactListId | string | Target an existing CRM list instead of a described audience: at launch the list is pushed to Meta as a hashed-email Custom Audience (find ids via crm.lists.lis… |
| locations | array | Where the ads run. For a local business list the places, e.g. ["Denver, Colorado"] or ["Mesa, Arizona", "Gilbert, Arizona"]. Omitted, targeting defaults to the… |
| radiusMiles | integer | Radius around each city, in miles. Typical local service business: 15 to 25. |
| platforms | array | Platforms to draft a campaign on; one campaign row per platform. |
ads__campaign__listList ad campaigns for the active business, optionally filtered by status and/or platform. Use when the user asks to see their campaigns or get an overview. The status of a launched campaign here is what Plyto last read from the ad platform (nightly, or the last refresh); before saying whether a cam…List ad campaigns for the active business, optionally filtered by status and/or platform. Use when the user asks to see their campaigns or get an overview. The status of a launched campaign here is what Plyto last read from the ad platform (nightly, or the last refresh); before saying whether a cam…
| Parámetro | Tipo | Descripción |
|---|---|---|
| status | array | Filter by status. Omit to get all statuses. |
| platforms | array | Filter by platforms. Omit for all. |
| limit | integer | — |
ads__performance__summaryTHE authoritative source for a campaign's spend, impressions, clicks and conversions: use this for any question about how much a campaign has spent or how it is performing. Defaults to last 7 days. Numbers are aggregated from daily snapshots written by the performance poller, and `asOf` says when t…THE authoritative source for a campaign's spend, impressions, clicks and conversions: use this for any question about how much a campaign has spent or how it is performing. Defaults to last 7 days. Numbers are aggregated from daily snapshots written by the performance poller, and `asOf` says when t…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | Plyto campaign id (returned from ads.campaign.list). |
| dateRange | object | Inclusive date range in YYYY-MM-DD. Defaults to the last 7 days. |
ads__performance__analyzeAnalyze recent performance for the active business: surface ads/ad sets that aren't getting impressions, ones spending without converting, and concentration patterns where a small slice drives most results. Also returns CRM attribution per campaign: leads captured (via stamped UTMs), cost per lead,…Analyze recent performance for the active business: surface ads/ad sets that aren't getting impressions, ones spending without converting, and concentration patterns where a small slice drives most results. Also returns CRM attribution per campaign: leads captured (via stamped UTMs), cost per lead,…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | Limit analysis to a single campaign. Omit to analyze the whole business. |
| dateRange | object | Inclusive date range in YYYY-MM-DD. Defaults to the last 14 days. |
ads__creative__draftCreate a draft ad creative attached to an existing ad set. Combines an uploaded image with copy + CTA + landing URL. The creative goes live with the ad set when the campaign is launched. Use after ads.campaign.draft and after the user has uploaded at least one image. PLACEMENT SIZES: a campaign nee…Create a draft ad creative attached to an existing ad set. Combines an uploaded image with copy + CTA + landing URL. The creative goes live with the ad set when the campaign is launched. Use after ads.campaign.draft and after the user has uploaded at least one image. PLACEMENT SIZES: a campaign nee…
| Parámetro | Tipo | Descripción |
|---|---|---|
| adSetId* | string | ID of an existing ad set in this business (returned from ads.campaign.draft). |
| name* | string | Internal name shown in the dashboard. |
| headline* | string | Short headline for the ad. Meta limits to ~40 chars. |
| body* | string | Primary ad copy shown above the image. Keep it under 125 characters: Facebook hides the rest behind "See more" and Instagram shows even less. One idea, the hoo… |
| description | string | Optional secondary description shown under the headline. |
| ctaType | string | Call-to-action button type. |
| destinationUrl* | string | Where the ad clicks land (your website, landing page, etc.). |
| destinationSource | string | Set to "user" ONLY when the owner typed this exact URL in this conversation. Otherwise omit: the link must be on the website on file or a Plyto-hosted page, an… |
| creativeAssetId* | string | ID of an uploaded creative asset (image) for this business. Use ads.assets.list to find one. |
ads__creative__generate_imagesGenerate AI ad photographs from a prompt + the business's brand profile, sized for Meta placements, and save them to the creative library. For a physical business the picture is the work or the product, and a REAL photo from the library (ads.creative.compose_from_photo) comes first when one exists;…Generate AI ad photographs from a prompt + the business's brand profile, sized for Meta placements, and save them to the creative library. For a physical business the picture is the work or the product, and a REAL photo from the library (ads.creative.compose_from_photo) comes first when one exists;…
| Parámetro | Tipo | Descripción |
|---|---|---|
| prompt* | string | The scene, briefed like an art director, not a category label. Brand profile (name, industry, audience, voice, colors) is added automatically; don't repeat it.… |
| name | string | Base name for the set shown in the library (e.g. "Summer promo"). Defaults to a prompt excerpt. |
| style | string | Visual treatment. photo (default): photorealistic scene, best for trades and local services. graphic: bold designed flat graphic with shapes and brand color, b… |
| ratios | array | Placement sizes to generate. Defaults to all four. 1:1 is required and always included. |
| adCreativeId | string | A draft ad to attach the generated 1:1 to automatically. When generating for a campaign's ads, call once PER AD with each ad's id so every image lands on its a… |
| headline | string | Headline to composite onto the image in real type (with the real logo). ALWAYS pass the ad's headline: if generation falls back to the brand template, a tile w… |
| subline | string | Smaller supporting line under the headline. Optional. |
ads__creative__compose_graphicCompose a DESIGNED ad graphic deterministically: real type, the real logo, the real product image, proof from the claims on file. No AI image model, no credits. To EDIT an existing designed graphic, pass revisionOf (its asset id) plus only the fields that change: the rest is kept, the old set is ar…Compose a DESIGNED ad graphic deterministically: real type, the real logo, the real product image, proof from the claims on file. No AI image model, no credits. To EDIT an existing designed graphic, pass revisionOf (its asset id) plus only the fields that change: the rest is kept, the old set is ar…
| Parámetro | Tipo | Descripción |
|---|---|---|
| revisionOf | string | EDITING an existing designed graphic: the asset id of any size in the set (the library card names it). Everything not passed is kept from it: headline, accent… |
| headline | string | The line set in real type: 3 to 8 words in the buyer's own words, with one specific. Required unless revisionOf is set. |
| accentPhrase | string | complete layout: the phrase that ENDS the headline, set in the brand accent on its own line. "Know which ads make money." with accentPhrase "make money." |
| subline | string | The mechanism line under the headline: how it works, with the concrete nouns (services, platforms, city, season). Up to 12 words. |
| proofTiles | array | complete layout: up to three short proof tiles for the strip ("8+ tools in one loop", "Licensed and insured", "12 years in Bend"). Each must come from the bran… |
| ctaLabel | string | complete layout: the painted button text. Defaults to the attached ad's own call to action so the picture and the real button agree; never a second, different… |
| ctaNote | string | complete layout: one short line under the button, only from facts on file ("No credit card. Unlimited seats."). |
| annotation | string | complete layout: two to four handwritten words with an arrow at the product ("From clicks to revenue"). A fact from the profile, never an offer or a number. |
| platformMarks | boolean | complete layout: draw the official Meta/Google marks in the platform chips. Defaults to yes on Meta campaigns and no on Google campaigns; leave unset. |
| layout | string | complete: the finished ad, and the layout for EVERY ad in a set unless the person asks for something else. Headline with an accent phrase, mechanism line, the… |
| heroAssetId | string | complete and screenshot layouts: a library image asset (a real product screenshot, the site capture, or a real photo) to frame as the hero. Use ads.assets.list… |
| name | string | — |
| ratios | array | — |
| adCreativeId | string | Draft ad to auto-attach the 1:1 to. The set it replaces is archived out of the library. |
ads__creative__compose_from_photoTurn a REAL photo from the library into a finished ad set: the photo cropped for every placement size, the headline in real type, the real logo. No image model, no credits, nothing invented. THE FIRST CHOICE for a physical business whenever the owner has uploaded photos or the website scan saved so…Turn a REAL photo from the library into a finished ad set: the photo cropped for every placement size, the headline in real type, the real logo. No image model, no credits, nothing invented. THE FIRST CHOICE for a physical business whenever the owner has uploaded photos or the website scan saved so…
| Parámetro | Tipo | Descripción |
|---|---|---|
| assetId* | string | A REAL photo from the library (ads.assets.list): uploaded by the owner or saved from their website. Never a generated image. |
| headline* | string | Composited in real type under the photo. Always the ad's headline. |
| subline | string | — |
| name | string | — |
| ratios | array | — |
| adCreativeId | string | Draft ad to auto-attach the 1:1 to. One call per ad. |
ads__creative__generate_videoRender a short video clip (4, 6 or 8 seconds, vertical 9:16 or wide 16:9) for Reels, Stories, TikTok-style and feed placements. Use for ANY request for a video, promo clip, reel or animated ad. It renders in the background for a few minutes; the finished clip lands in Creative studio (Marketing, Cr…Render a short video clip (4, 6 or 8 seconds, vertical 9:16 or wide 16:9) for Reels, Stories, TikTok-style and feed placements. Use for ANY request for a video, promo clip, reel or animated ad. It renders in the background for a few minutes; the finished clip lands in Creative studio (Marketing, Cr…
| Parámetro | Tipo | Descripción |
|---|---|---|
| prompt* | string | What happens in the clip: shot type, subject, action, setting, light. One continuous moment, one subject. Describe the SCENE only. No words, captions, logos or… |
| name | string | Library name for the clip. |
| aspectRatio | string | 9:16 for Reels, Stories and TikTok-style placements. 16:9 for feed and YouTube. |
| durationSeconds | — | Clip length. 8 suits most ads; 4 for a single beat; 6 in between. |
| hook | string | The one line shown over the opening seconds of the FINISHED ad. Pass it whenever the clip is for an ad (it almost always is): the moment the clip lands, Plyto… |
| caption | string | One lower-third line for the clip in the finished ad. |
| cta | string | Button label on the closing brand card, e.g. "Get a quote", "Start free". Default "Learn more". |
| engine | string | Leave unset: the workspace default renders. Only when the person names the engine (a side-by-side of Veo against Gemini Omni Flash). |
| fromAssetId | string | A library IMAGE to open on: a real photo of the place or product beats an invented scene. When the person attached photos, pick the clearest product or place s… |
ads__creative__compose_videoTurn library clips and images into a FINISHED video ad: a hook line over the opening seconds, an optional caption per clip, and a closing brand card with the real logo and a button, at 9:16 for Reels, Stories and TikTok (or 16:9, 1:1). A raw clip from ads.creative.generate_video is footage, not an…Turn library clips and images into a FINISHED video ad: a hook line over the opening seconds, an optional caption per clip, and a closing brand card with the real logo and a button, at 9:16 for Reels, Stories and TikTok (or 16:9, 1:1). A raw clip from ads.creative.generate_video is footage, not an…
| Parámetro | Tipo | Descripción |
|---|---|---|
| assetIds | array | Library clips and images IN ORDER (1 to 4). Clips play up to 12 seconds each; images hold for a few seconds with a slow push-in. Omit to use the newest generat… |
| hook* | string | The one line shown large over the first two to three seconds. The reason to keep watching, in the customer's words: a pain, a promise or a question. Under 60 c… |
| captions | array | One short caption per clip, in the same order as assetIds (null to leave a clip clean). Lower third, one idea each. |
| clipSeconds | number | Trim every clip to this many seconds. Default: each clip's own length, up to 12. |
| endHeadline | string | Headline on the closing brand card. Default: the hook. |
| endSubline | string | Supporting line on the closing card. Default: the business's value proposition. |
| cta | string | Button label on the closing card, e.g. "Get a quote", "Book now", "Start free". Default "Learn more". |
| noEndCard | boolean | Skip the closing brand card. |
| aspect | string | 9:16 for Reels, Stories and TikTok (the default). 16:9 for feed and YouTube. 1:1 for square feed. |
| muteClips | boolean | Drop the clips' own sound. |
| name | string | Library name for the finished ad. |
ads__ads__listList every ad on a campaign with its ID, grouped by ad group. Run this BEFORE ads.creative.update or ads.creative.delete: those tools take the ad's id, never its headline text. Also the honest way to answer 'what ads does this campaign have'.List every ad on a campaign with its ID, grouped by ad group. Run this BEFORE ads.creative.update or ads.creative.delete: those tools take the ad's id, never its headline text. Also the honest way to answer 'what ads does this campaign have'.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign whose ads to list. |
ads__assets__listList the creative library (images, videos) for the active business, with what each asset IS: role 'site-capture' is the real picture of their website the scan saved (the hero for ads.creative.compose_graphic layout screenshot on software), role 'reference' is a real photo of the business, source 'u…List the creative library (images, videos) for the active business, with what each asset IS: role 'site-capture' is the real picture of their website the scan saved (the hero for ads.creative.compose_graphic layout screenshot on software), role 'reference' is a real photo of the business, source 'u…
| Parámetro | Tipo | Descripción |
|---|---|---|
| type | string | Filter by asset type. Omit for all. |
ads__assets__deleteprivilegiadaPermanently delete an UNUSED image or video from the creative library (the file and its record). Refused when the asset — or any of its placement-size siblings (same name, different ratio) — is attached to an ad, because launch resolves sibling sizes by name. Use for library hygiene: failed or supe…Permanently delete an UNUSED image or video from the creative library (the file and its record). Refused when the asset — or any of its placement-size siblings (same name, different ratio) — is attached to an ad, because launch resolves sibling sizes by name. Use for library hygiene: failed or supe…
| Parámetro | Tipo | Descripción |
|---|---|---|
| assetId* | string | The creative asset to delete permanently. |
ads__campaign__updateEdit an existing ad campaign: name, objective, daily budget, plain-English audience, or Google search keywords. Draft campaigns are freely editable. For LIVE campaigns only the budget can change and an increase requires the user's explicit approval first (then pass confirmSpendIncrease: true). Neve…Edit an existing ad campaign: name, objective, daily budget, plain-English audience, or Google search keywords. Draft campaigns are freely editable. For LIVE campaigns only the budget can change and an increase requires the user's explicit approval first (then pass confirmSpendIncrease: true). Neve…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign to edit. |
| name | string | — |
| objective | string | — |
| dailyBudgetDollars | number | — |
| audienceDescription | string | Plain-English audience; replaces the first ad set's audience. |
| googleKeywords | array | Search keywords (google campaigns only). Cover EVERY intent in the audience description: when it names competitors or 'alternatives to X', include those altern… |
| adSetId | string | Which ad group (ad set) the audience/keyword change targets. Campaigns can have several ad groups, each with its own keyword theme; ads.campaign.get lists them… |
| confirmSpendIncrease | boolean | REQUIRED true when raising the budget of a live campaign. Only set after the user explicitly approved the new amount in chat. Never state a live campaign's cur… |
ads__campaign__locations__getWhere a campaign's ads show: the location targeting as the ad platform itself reports it for a live or paused campaign (Google: the places plus whether only people physically there see the ads; Meta: the places on every ad set), or what the draft holds. Use before changing locations, when someone a…Where a campaign's ads show: the location targeting as the ad platform itself reports it for a live or paused campaign (Google: the places plus whether only people physically there see the ads; Meta: the places on every ad set), or what the draft holds. Use before changing locations, when someone a…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign to inspect. |
ads__campaign__changesThe change history of a campaign: every edit made through Plyto (budget, locations, keywords, bidding, status, ads), by whom and when, plus, for a live Google campaign, Google's own change log including edits made directly in Google Ads by a person. Use before explaining why results changed, before…The change history of a campaign: every edit made through Plyto (budget, locations, keywords, bidding, status, ads), by whom and when, plus, for a live Google campaign, Google's own change log including edits made directly in Google Ads by a person. Use before explaining why results changed, before…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign whose history to read. |
| days | integer | How far back to look. Google's own history covers 30 days at most. |
ads__landing_pages__buildBuild a landing page for every ad group in a campaign (or one ad group): a Plyto-hosted page whose headline says the ad's promise back in the visitor's words, brand-grounded bullets, proof only from the claims on file, and the business's lead form. Draft campaigns: the ads' links are set to the pag…Build a landing page for every ad group in a campaign (or one ad group): a Plyto-hosted page whose headline says the ad's promise back in the visitor's words, brand-grounded bullets, proof only from the claims on file, and the business's lead form. Draft campaigns: the ads' links are set to the pag…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign whose ad groups get pages. |
| adSetId | string | One ad group only. Omit for every ad group in the campaign. |
| repointLiveAds | boolean | Move the SERVING ads of a live Google campaign onto the new pages. Leave this out unless the user has read the pages and said in this conversation to send thei… |
ads__landing_pages__listThe landing pages Plyto hosts for this business's ads, with their links, which campaign and ad group each belongs to, and how many people have viewed each. Use before building pages (to reuse), and when someone asks where an ad sends people.The landing pages Plyto hosts for this business's ads, with their links, which campaign and ad group each belongs to, and how many people have viewed each. Use before building pages (to reuse), and when someone asks where an ad sends people.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | Limit to one campaign. Omit for every page in the business. |
ads__landing_pages__getEverything on one landing page, for reading back or editing: every line of copy, the photo, the accent color, whether it collects details (form) or sends people to a link, which ad it belongs to and whether traffic is reaching it, what the owner has edited by hand. Call it before ads.landing_pages.…Everything on one landing page, for reading back or editing: every line of copy, the photo, the accent color, whether it collects details (form) or sends people to a link, which ad it belongs to and whether traffic is reaching it, what the owner has edited by hand. Call it before ads.landing_pages.…
| Parámetro | Tipo | Descripción |
|---|---|---|
| pageId* | string | The page's id or slug, from ads.landing_pages.list or the address the owner pasted. |
ads__landing_pages__updateEdit one landing page: pass ONLY what changes and everything else stays. 'Change the headline to X' is headline alone; 'I don't like the color' is accent alone; 'send people to my booking link' is destination link plus ctaUrl; 'put my Calendly (or my Typeform, my HubSpot form) on the page' is desti…Edit one landing page: pass ONLY what changes and everything else stays. 'Change the headline to X' is headline alone; 'I don't like the color' is accent alone; 'send people to my booking link' is destination link plus ctaUrl; 'put my Calendly (or my Typeform, my HubSpot form) on the page' is desti…
| Parámetro | Tipo | Descripción |
|---|---|---|
| pageId* | string | The page's id or slug. |
| headline | string | — |
| subheadline | string | — |
| bullets | array | Replaces the whole list when passed. Each is a bold lead sentence then one detail sentence. |
| steps | array | What happens after they get in touch, from their side. Replaces the whole list when passed. |
| heroCaption | string | One true line under the photo. Never a job, street or outcome that was not stated. |
| proof | array | Trust lines under the form. Only claims on file. |
| ctaLabel | string | — |
| destination | string | form: the page collects details with the Plyto lead form (leads become contacts tied to the ad). link: the button goes to ctaUrl (their booking page, shop, tel… |
| ctaUrl | string | Where the button goes when destination is link. |
| embed | string | The share link or the embed code of their form or calendar, as the owner pasted it, when destination is embed. |
| heroImageUrl | string | A url from ads.assets.list. The library only; never an outside address. |
| accent | string | Hex like #1f5f3b. Buttons, the top bar, the step numbers. Omit to keep; unset to go back to the brand color. |
| tags | array | The owner's own labels. Replaces the list. |
| unset | array | Fields to clear. |
ads__landing_pages__createMake ANOTHER landing page for an ad group: a second angle to test against the page ads.landing_pages.build made, a page for a new offer, a variant the owner asked for. You give the ANGLE; Plyto's copywriter writes the page from the ad's words, the brand profile and the claims on file, through the s…Make ANOTHER landing page for an ad group: a second angle to test against the page ads.landing_pages.build made, a page for a new offer, a variant the owner asked for. You give the ANGLE; Plyto's copywriter writes the page from the ad's words, the brand profile and the claims on file, through the s…
| Parámetro | Tipo | Descripción |
|---|---|---|
| adSetId* | string | The ad group this page answers (ads.campaign.get lists ad groups with ids). |
| angle* | string | The pitch this page leads with, different from the ad group's existing page: 'lead with the insurance claim', 'proof first', 'the owner's own voice', 'the spri… |
| ownerNotes | string | Facts the owner stated in this conversation that the page may use, in their words (an offer, a price, a timeframe, a credential). Never anything they did not s… |
| headline | string | ONLY when the owner dictated the exact headline. Otherwise leave it to the copywriter. |
| ctaLabel | string | Only when the owner named the button. |
| destination | string | form (default for a business that calls people back), link to ctaUrl (the signup or checkout page for self-serve software), or embed their own form or calendar. |
| ctaUrl | string | — |
| embed | string | — |
| heroImageUrl | string | A url from ads.assets.list. Omit and the ad's own picture, or the newest real photo of the business, is used. |
| accent | string | — |
| tags | array | — |
| pointDraftAds | boolean | On a DRAFT campaign only: make this the page the ad group's ads link to. Live ads never move here; the owner does that from the page's screen. |
ads__campaign__launchLaunch a DRAFT campaign on Facebook and Instagram or Google Ads, the same way the Run it button does: checks that the ad account, payment method, Page and lead capture are in place, then starts the launch in the background. Money moves after this, so call it once WITHOUT confirmLaunch to get the ex…Launch a DRAFT campaign on Facebook and Instagram or Google Ads, the same way the Run it button does: checks that the ad account, payment method, Page and lead capture are in place, then starts the launch in the background. Money moves after this, so call it once WITHOUT confirmLaunch to get the ex…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The DRAFT campaign to launch. |
| confirmLaunch | boolean | REQUIRED true to launch. Set it only after the user explicitly said to launch THIS campaign at the daily budget the first call reported. Never on the same turn… |
ads__campaign__status__setPause a live campaign or resume a paused one on the ad platform, the same path as the page's pause and resume buttons (platform call, audit row, undoable). Pausing needs no confirmation and stops spend at once. Resuming restarts spend, so it needs confirmResume: true after the user asked. To pause…Pause a live campaign or resume a paused one on the ad platform, the same path as the page's pause and resume buttons (platform call, audit row, undoable). Pausing needs no confirmation and stops spend at once. Resuming restarts spend, so it needs confirmResume: true after the user asked. To pause…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | A LIVE or PAUSED campaign. |
| to* | string | "paused" stops spend on the platform; "live" resumes it. |
| confirmResume | boolean | REQUIRED true when to is "live": resuming restarts spend. Set only after the user explicitly asked to resume this campaign. |
ads__campaign__refreshPull the current state of launched campaigns, their ad groups and their ads straight from Google Ads and Facebook, and match Plyto's records to it: live or paused at every level, the campaign's daily budget, each ad's review state, and any delivery problem the platform reports. Plyto otherwise lear…Pull the current state of launched campaigns, their ad groups and their ads straight from Google Ads and Facebook, and match Plyto's records to it: live or paused at every level, the campaign's daily budget, each ad's review state, and any delivery problem the platform reports. Plyto otherwise lear…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | One launched campaign. Omit to check every launched campaign in the business. |
ads__destination__getWhere this business's ad clicks go, or, when nobody has decided yet, the numbered question to ask the owner (their site's real pages checked live, a recommendation and why). A draft's result already carries this as destinationAsk; call this when you need it again or before launching. Never decide i…Where this business's ad clicks go, or, when nobody has decided yet, the numbered question to ask the owner (their site's real pages checked live, a recommendation and why). A draft's result already carries this as destinationAsk; call this when you need it again or before launching. Never decide i…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | The draft in question, so a Facebook draft also offers the instant form and the answer can be checked against its ads. |
ads__destination__setRecord where the owner wants ad clicks to go, then do what that implies: build and host the landing page (page, or an embeddable link), point the campaign's draft ads at their site or link (site, link), or mark a Facebook draft for an instant form. Call it the moment they answer the destination que…Record where the owner wants ad clicks to go, then do what that implies: build and host the landing page (page, or an embeddable link), point the campaign's draft ads at their site or link (site, link), or mark a Facebook draft for an instant form. Call it the moment they answer the destination que…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | The draft this decides for: pages are built for it and its draft ads are pointed. Omit to record the choice for future drafts only. |
| choice* | string | page: Plyto builds and hosts a landing page per ad group (a lead form, or a button to url when pageAction is link). site: a page on the owner's own website; pa… |
| url | string | For site and link: the address the owner gave, as they gave it. For page with pageAction link: the link the page's button opens. |
| pageAction | string | For page: what the page ends in. form (default): a short lead form we host, leads land in the CRM. link: a button to url. |
| domain | string | For page, only when the owner asked to host it on their own domain: a subdomain of theirs (go.theirsite.com). DNS comes after and never blocks the launch. |
| decidedBy | string | owner (default) when they answered. agent when they said 'you pick' and you took the recommendation; say which you chose. |
ads__funnel__summaryThe funnel behind the ad spend, by campaign, for the last N days: spend, clicks, and every stage after the click through to a paying customer, with cost per stage. Call this BEFORE judging a campaign, proposing a budget change, or answering 'what should we change about our ads': the platform's conv…The funnel behind the ad spend, by campaign, for the last N days: spend, clicks, and every stage after the click through to a paying customer, with cost per stage. Call this BEFORE judging a campaign, proposing a budget change, or answering 'what should we change about our ads': the platform's conv…
| Parámetro | Tipo | Descripción |
|---|---|---|
| days | integer | Window in days, default 30. |
ads__campaign__locations__setSet or replace the location targeting on a campaign, DRAFT or LIVE: plain place names, applied to every ad group, plus (Google) whether the ads reach only people physically in those places. Use when the checklist warns about missing locations, when targeting defaulted to the business's country and…Set or replace the location targeting on a campaign, DRAFT or LIVE: plain place names, applied to every ad group, plus (Google) whether the ads reach only people physically in those places. Use when the checklist warns about missing locations, when targeting defaulted to the business's country and…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign whose targeting to set. |
| locationNames* | array | Plain place names: cities, regions, or countries ("United States", "Toronto", "England"). Replaces the campaign's current locations on every ad group. |
| radiusMiles | — | Optional radius around each place, for local businesses. |
| presence | string | Google only. "presence" = people in or regularly in the places (the right choice almost always: it stops searchers in other countries seeing the ads). "presenc… |
| confirmLiveEdit | boolean | REQUIRED true for a LIVE or paused campaign: the change reaches Google or Meta immediately. Set true only after the user explicitly asked to change where this… |
ads__creative__addAdd one ad (headline + primary text + CTA, plus a link except on a Meta leads campaign, where the instant form is the destination and no link is needed) to a campaign's ad set. On a DRAFT it is saved and launches with the campaign. On a LIVE Google campaign it publishes a new responsive search ad i…Add one ad (headline + primary text + CTA, plus a link except on a Meta leads campaign, where the instant form is the destination and no link is needed) to a campaign's ad set. On a DRAFT it is saved and launches with the campaign. On a LIVE Google campaign it publishes a new responsive search ad i…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | — |
| headline* | string | — |
| body* | string | — |
| ctaType | string | — |
| destinationUrl | string | — |
| destinationSource | string | Set to "user" ONLY when the owner typed this exact URL in this conversation. Otherwise omit: the link must be on the website on file or a Plyto-hosted page, an… |
| adGroupName | string | For campaigns with several ad groups: a fragment of the ad group's name to add the ad into. Defaults to the first ad group. |
| confirmLiveEdit | boolean | Required to publish an ad into a LIVE Google campaign (it reaches Google immediately). Omit for drafts. Set true only after the user explicitly asked to edit t… |
ads__creative__attach_imageAttach a creative-library image OR video clip to a draft ad (sets it as the ad's media; for image sets, launch resolves the other placement sizes by the asset's name-siblings; a video clip launches as a Meta video ad that plays in Reels, Stories and the feed). Use right after ads.creative.generate_…Attach a creative-library image OR video clip to a draft ad (sets it as the ad's media; for image sets, launch resolves the other placement sizes by the asset's name-siblings; a video clip launches as a Meta video ad that plays in Reels, Stories and the feed). Use right after ads.creative.generate_…
| Parámetro | Tipo | Descripción |
|---|---|---|
| adCreativeId* | string | The ad to attach the image to (from the campaign's ads list). |
| assetId* | string | The creative-library image or video clip to attach (from ads.creative.generate_images, ads.creative.generate_video or the library). |
ads__audience__listList the Meta custom audiences and lookalikes on the connected ad account, with their approximate sizes. Use when the user asks what audiences they have, or before targeting or building one.List the Meta custom audiences and lookalikes on the connected ad account, with their approximate sizes. Use when the user asks what audiences they have, or before targeting or building one.
| Parámetro | Tipo | Descripción |
|---|---|---|
| refresh | boolean | Re-pull from Meta instead of using the cached list. Use when the user just created an audience elsewhere. |
ads__audience__createCreate a Meta audience for the business: either a custom audience from one of their Plyto contact lists, or a lookalike of an audience they already have. Use when the user wants to target their customers, or reach 'people like' their best customers. Creating an audience spends nothing and changes n…Create a Meta audience for the business: either a custom audience from one of their Plyto contact lists, or a lookalike of an audience they already have. Use when the user wants to target their customers, or reach 'people like' their best customers. Creating an audience spends nothing and changes n…
| Parámetro | Tipo | Descripción |
|---|---|---|
| userAskedToCreate* | boolean | True only if the user explicitly asked you to build this audience on Meta. Discussing who to target, or being asked what audiences exist, is not asking you to… |
| name* | string | Name for the new audience, as it will appear in Meta. |
| fromListId | string | Build a custom audience from this Plyto contact list (emails are hashed before upload). Use crm.list.* tools to find the id. |
| lookalikeOfAudienceId | string | Build a lookalike seeded from this existing Meta audience id (from ads.audience.list). |
| lookalikePercent | number | Lookalike breadth as a percent of the country's population. 1 is the closest match and usually performs best; 10 is broadest. |
| country | string | Two-letter country code the lookalike is built in. |
ads__audience__interestsSearch Meta's interest and behavior catalog for detailed targeting, with approximate audience sizes. Use when the user wants to target people by interest, or asks what interests they could target. Returns ids that can be attached to an ad set.Search Meta's interest and behavior catalog for detailed targeting, with approximate audience sizes. Use when the user wants to target people by interest, or asks what interests they could target. Returns ids that can be attached to an ad set.
| Parámetro | Tipo | Descripción |
|---|---|---|
| query* | string | What to search for, e.g. 'home improvement' or 'yoga'. |
| limit | integer | — |
ads__search_terms__listShow what people actually searched for before seeing the business's Google ads, with spend, clicks and conversions per term, and which terms are wasting money (spend with zero conversions). Use when asked where the ad budget is going, why costs are high, or what to block. This report is PARTIAL: Go…Show what people actually searched for before seeing the business's Google ads, with spend, clicks and conversions per term, and which terms are wasting money (spend with zero conversions). Use when asked where the ad budget is going, why costs are high, or what to block. This report is PARTIAL: Go…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | Limit to one Plyto campaign. Omit for the whole account. |
| days | — | Reporting window. |
| onlyWasteful | boolean | Return just the zero-conversion terms worth blocking, instead of everything. |
ads__negative_keywords__addBlock search terms on a Google campaign by adding them as negative keywords, so the ads stop showing for that traffic. Use after finding wasteful terms. This lowers wasted spend and never raises a budget.Block search terms on a Google campaign by adding them as negative keywords, so the ads stop showing for that traffic. Use after finding wasteful terms. This lowers wasted spend and never raises a budget.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The Plyto campaign to block them on. |
| terms* | array | Search terms to stop showing ads for. |
| matchType | string | BROAD blocks the whole family of that phrasing (right for junk traffic); EXACT blocks only that precise spelling. |
ads__negative_keywords__listList the negative keywords already blocking traffic on a Google campaign. Use before adding more, so nothing is added twice.List the negative keywords already blocking traffic on a Google campaign. Use before adding more, so nothing is added twice.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The Plyto campaign to read. |
ads__delivery__diagnoseExplain why live campaigns are or aren't delivering: learning phase, budget too small to enter the auction, rejected ads, audience too narrow, payment problems. Use whenever the user asks why a campaign has low or zero spend, impressions, or results.Explain why live campaigns are or aren't delivering: learning phase, budget too small to enter the auction, rejected ads, audience too narrow, payment problems. Use whenever the user asks why a campaign has low or zero spend, impressions, or results.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | Limit to one campaign. Omit to check every live campaign. |
ads__google_audience__listList the Customer Match and remarketing audiences on the connected Google Ads account, with their sizes. Use when the user asks what Google audiences they have or before targeting one.List the Customer Match and remarketing audiences on the connected Google Ads account, with their sizes. Use when the user asks what Google audiences they have or before targeting one.
No se publicó ningún esquema de entrada para esta herramienta.
ads__google_audience__createTEMPORARILY UNAVAILABLE: Google approved Plyto for conversion reporting, and approval for customer list uploads is still pending, so this tool currently refuses with an explanation. When a user asks for a Google audience, say that plainly and offer keyword targeting on Google or the same audience o…TEMPORARILY UNAVAILABLE: Google approved Plyto for conversion reporting, and approval for customer list uploads is still pending, so this tool currently refuses with an explanation. When a user asks for a Google audience, say that plainly and offer keyword targeting on Google or the same audience o…
| Parámetro | Tipo | Descripción |
|---|---|---|
| userAskedToCreate* | boolean | True only if the user explicitly asked you to upload this list to Google as an audience. Discussing targeting, or listing existing audiences, is not asking you… |
| listId* | string | Plyto contact list to push to Google as an audience. |
| name | string | Name for the audience in Google Ads. |
ads__lead_form__listList the Facebook instant forms (lead forms) on the connected page, with how many leads each has collected. Use when the user asks about their lead forms or before pointing a campaign at one.List the Facebook instant forms (lead forms) on the connected page, with how many leads each has collected. Use when the user asks about their lead forms or before pointing a campaign at one.
No se publicó ningún esquema de entrada para esta herramienta.
ads__lead_form__createCreate a real instant form on the business's Facebook page. It becomes a live asset on their page that collects strangers' names, emails and phone numbers, and Facebook does not let you delete forms that have submissions. Submissions land in Contacts automatically.Create a real instant form on the business's Facebook page. It becomes a live asset on their page that collects strangers' names, emails and phone numbers, and Facebook does not let you delete forms that have submissions. Submissions land in Contacts automatically.
| Parámetro | Tipo | Descripción |
|---|---|---|
| userAskedToCreate* | boolean | True only if the user explicitly asked you to create this lead form on their Facebook page. Discussing form fields, or drafting one, is not asking you to creat… |
| name* | string | Internal name for the form. |
| headline* | string | Shown at the top of the form, e.g. 'Get a free roof estimate'. |
| description | string | One short supporting line under the headline. |
| fields | array | Fields to ask for beyond email, which is always included. Every extra field costs submissions. |
| websiteUrl* | string | Where the thank-you screen sends people. |
| privacyPolicyUrl* | string | Required by Meta. Use the business website if there's no policy page. |
| quality | string | HIGHER_INTENT adds a review step: fewer leads, better ones. Suggest it for high-ticket services. |
ads__google__conversion_tracking__repairSet up Google conversion tracking for a business that is missing it, and move live Google campaigns from bidding on clicks to bidding on conversions. Use when a campaign launched without conversion tracking, or when the campaign page reports that setup failed. Changes how the campaign bids; it does…Set up Google conversion tracking for a business that is missing it, and move live Google campaigns from bidding on clicks to bidding on conversions. Use when a campaign launched without conversion tracking, or when the campaign page reports that setup failed. Changes how the campaign bids; it does…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId | string | Limit the repair to one campaign. Omit to fix every live Google campaign on this business. |
ads__destinations__syncPush the landing page URLs shown in Plyto to the live ads on Google, for a campaign whose destinations were changed after launch. Use when ads are sending traffic somewhere other than what the campaign page shows. Changes where clicks land; it does not change budget or spend.Push the landing page URLs shown in Plyto to the live ads on Google, for a campaign whose destinations were changed after launch. Use when ads are sending traffic somewhere other than what the campaign page shows. Changes where clicks land; it does not change budget or spend.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live Google campaign to sync. |
ads__google__search_partners__setTurn Google Search Partners on or off for a live campaign. Partner sites deliver cheap clicks with high click-through rates and far worse conversion than Google Search, so turning them off is the standard fix when a campaign shows an implausible click-through rate and no results. Changes where ads…Turn Google Search Partners on or off for a live campaign. Partner sites deliver cheap clicks with high click-through rates and far worse conversion than Google Search, so turning them off is the standard fix when a campaign shows an implausible click-through rate and no results. Changes where ads…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live Google campaign to change. |
| enabled* | boolean | false turns Google's partner sites off, which is the usual fix for cheap clicks that never convert. true opts back in. |
ads__google__bidding__setSwitch a live Google campaign between clicks bidding and conversions bidding. Use maximize_clicks when a campaign shows zero or near-zero impressions on Google Search because it is optimizing toward conversions that never get recorded. Spends the same daily budget either way; does not raise it.Switch a live Google campaign between clicks bidding and conversions bidding. Use maximize_clicks when a campaign shows zero or near-zero impressions on Google Search because it is optimizing toward conversions that never get recorded. Spends the same daily budget either way; does not raise it.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live Google campaign to change. |
| mode* | string | maximize_clicks buys as many clicks as the budget allows, capped per click; the right mode while conversion tracking has no data. maximize_conversions hands bi… |
| maxCpcDollars | number | Ceiling per click in dollars for maximize_clicks, defaulting to 4. Ignored for maximize_conversions. |
ads__google__ads__strengthenFill every live responsive search ad in a Google campaign up to the full 15-headline / 4-description asset counts, keeping all existing lines and pins and adding brand and ad-group-themed lines. Use when Google rates the ads' Ad strength Poor: thin asset lists cap Ad strength, and Poor strength cos…Fill every live responsive search ad in a Google campaign up to the full 15-headline / 4-description asset counts, keeping all existing lines and pins and adding brand and ad-group-themed lines. Use when Google rates the ads' Ad strength Poor: thin asset lists cap Ad strength, and Poor strength cos…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live Google campaign whose ads to strengthen. |
ads__creative__updateEdit an existing ad's headline, description, or destination link. Drafts update in place. A live Google search ad gets a replacement version published and the old one paused, because Google does not allow editing published ad copy; destination-only changes update in place. Live Meta ads cannot be e…Edit an existing ad's headline, description, or destination link. Drafts update in place. A live Google search ad gets a replacement version published and the old one paused, because Google does not allow editing published ad copy; destination-only changes update in place. Live Meta ads cannot be e…
| Parámetro | Tipo | Descripción |
|---|---|---|
| creativeId* | string | The ad (creative) to edit. |
| headline | string | New headline. Google search ads fit 30 characters. |
| body | string | New description (Google, 90 characters) or primary text (Meta). |
| destinationUrl | string | New landing page link, starting with https:// |
ads__creative__deleteprivilegiadaDelete a DRAFT ad outright (its images stay in the library), or PAUSE a live Google search ad (published ads can't be deleted, but a paused ad stops serving immediately). Use when a pre-launch check flags an ad the user wants gone — a trademarked competitor name in a headline, off-brand copy — inst…Delete a DRAFT ad outright (its images stay in the library), or PAUSE a live Google search ad (published ads can't be deleted, but a paused ad stops serving immediately). Use when a pre-launch check flags an ad the user wants gone — a trademarked competitor name in a headline, off-brand copy — inst…
| Parámetro | Tipo | Descripción |
|---|---|---|
| creativeId* | string | The ad (creative) to delete. |
ads__funnel__testSend a tagged test lead through a campaign's whole funnel: landing page, form, CRM contact, conversion attribution, and a dry-run Google upload check. The test lead uses an undeliverable address, is removed afterwards, and no ads or budgets change. Use when someone asks whether their tracking or fu…Send a tagged test lead through a campaign's whole funnel: landing page, form, CRM contact, conversion attribution, and a dry-run Google upload check. The test lead uses an undeliverable address, is removed afterwards, and no ads or budgets change. Use when someone asks whether their tracking or fu…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live campaign whose funnel to test. |
ads__google__keywords__addAdd keywords to a live Google campaign's ad group, phrase match by default. Use to feed phrasing families that are converting, for example when winning search terms are not yet covered by the keyword list. Does not change budget; new keywords compete inside the existing daily cap.Add keywords to a live Google campaign's ad group, phrase match by default. Use to feed phrasing families that are converting, for example when winning search terms are not yet covered by the keyword list. Does not change budget; new keywords compete inside the existing daily cap.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The live Google campaign. |
| adGroupName* | string | Which ad group to add to, matched by name fragment. |
| keywords* | array | Keywords to add. Plain text becomes phrase match. |
ads__google__ads__add_landing_variantStart a landing page A/B test on the live Google campaign. In ad groups with room it adds a copy of the strongest ad pointing at the new URL; in groups already at Google's 3-ad cap it repoints the weakest ad instead, keeping the strongest on the incumbent page. Google's ad rotation splits the traff…Start a landing page A/B test on the live Google campaign. In ad groups with room it adds a copy of the strongest ad pointing at the new URL; in groups already at Google's 3-ad cap it repoints the weakest ad instead, keeping the strongest on the incumbent page. Google's ad rotation splits the traff…
| Parámetro | Tipo | Descripción |
|---|---|---|
| variantUrl* | string | Full landing page URL for the B side, e.g. https://plyto.ai/go/new-era |
| adGroupNameContains | string | Only add the variant ad to ad groups whose name contains this text (case-insensitive). Omit to cover every enabled ad group. |
ads__query_pages__buildThe query-to-page engine: cluster what people actually searched on a live Google campaign, generate one landing page per intent cluster (headline that speaks the search back, brand-grounded copy, the business's live form embedded), and point variant ads at each page. Charges AI credits for the copy…The query-to-page engine: cluster what people actually searched on a live Google campaign, generate one landing page per intent cluster (headline that speaks the search back, brand-grounded copy, the business's live form embedded), and point variant ads at each page. Charges AI credits for the copy…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | A LIVE Google campaign with recorded search terms. |
| maxPages | integer | — |
ads__google__ad_groups__addAdd a complete search ad group (keywords phrase-match by default, RSA copy) to a SPECIFIC Google campaign by id. Where its clicks go follows the owner's decision on file (a page Plyto builds for the group, or their own link); undecided, the result carries the question to ask. Pass 8-12 VARIED headl…Add a complete search ad group (keywords phrase-match by default, RSA copy) to a SPECIFIC Google campaign by id. Where its clicks go follows the owner's decision on file (a page Plyto builds for the group, or their own link); undecided, the result carries the question to ask. Pass 8-12 VARIED headl…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | REQUIRED: the exact campaign this group belongs to. A draft id adds a draft group (nothing touches Google until launch); a live id is refused unless confirmLiv… |
| confirmLiveEdit | boolean | Set true ONLY when the user explicitly asked to edit this specific LIVE campaign. Never set it while building a new campaign. |
| name* | string | Short intent-family name, e.g. 'Agencies'. The campaign name is prefixed automatically. |
| keywords* | array | Search keywords for this intent. Bare strings become phrase match; [brackets] force exact. |
| landingUrl | string | Only when the owner named the link in this conversation (then also pass destinationSource "user") or the business has already decided where clicks go (business… |
| destinationSource | string | Set to "user" ONLY when the owner typed this exact URL in this conversation. Otherwise omit: the link must be on the website on file or a Plyto-hosted page, an… |
| headlines* | array | RSA headlines, 30 characters max each. Aim for 10 or more so Ad strength starts healthy. |
| descriptions* | array | RSA descriptions, 90 characters max each. |
ads__google__ad_groups__removeprivilegiadaRemove an ad group you (or the user) no longer want. Draft groups are deleted outright along with their draft ads. Groups on a LIVE campaign are PAUSED in Google instead: delivery stops immediately, history is kept, and the pause is reversible in Google Ads. Use this to clean up groups created by m…Remove an ad group you (or the user) no longer want. Draft groups are deleted outright along with their draft ads. Groups on a LIVE campaign are PAUSED in Google instead: delivery stops immediately, history is kept, and the pause is reversible in Google Ads. Use this to clean up groups created by m…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The campaign the ad group belongs to. |
| adSetId* | string | The ad group's id (from the campaign page or ads.campaign.list). |
ads__campaign__deleteprivilegiadaDelete a campaign that never launched (draft or failed): the campaign, its ad groups, and its draft ads are removed permanently; images stay in the creative library. A campaign that has reached the ad platform is archived instead of deleted, and a LIVE campaign is refused until it is paused. Two-st…Delete a campaign that never launched (draft or failed): the campaign, its ad groups, and its draft ads are removed permanently; images stay in the creative library. A campaign that has reached the ad platform is archived instead of deleted, and a LIVE campaign is refused until it is paused. Two-st…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The draft campaign to delete. |
| confirm | boolean | Must be true to actually delete. Call WITHOUT it first: the tool returns what would be deleted so you can confirm with the user. Set true only after the user h… |
ads__google__extensions__generateDraft sitelinks, callouts, and a structured snippet for a DRAFT Google campaign from the brand profile and the campaign's own keywords, and save them onto the draft. They are applied to Google at launch. URL VERIFICATION IS BUILT IN: sitelink destinations are chosen from the site's own sitemap and…Draft sitelinks, callouts, and a structured snippet for a DRAFT Google campaign from the brand profile and the campaign's own keywords, and save them onto the draft. They are applied to Google at launch. URL VERIFICATION IS BUILT IN: sitelink destinations are chosen from the site's own sitemap and…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | The DRAFT Google campaign to draft extensions for. |
| landingUrl | string | Base URL for sitelinks: the website on file or a Plyto-hosted page. Defaults to the campaign's ad destination. Never a guessed domain. |
| destinationSource | string | Set to "user" ONLY when the owner typed this exact URL in this conversation. Otherwise omit: the link must be on the website on file or a Plyto-hosted page, an… |
| sitelinks | array | EXPLICIT sitelinks that override generation. Pass these whenever the user names specific pages: each URL is still live-verified, and dead ones are dropped with… |
| callouts | array | EXPLICIT callouts (max 25 chars each) that override generation, saved verbatim. Pass these to change callouts, or to pin the current ones unchanged during a si… |
email__create_templateCreate a reusable email template. Body and subject are plain text and support merge tags: {{contact.firstName}}, {{contact.lastName}}, {{contact.fullName}}, {{contact.email}}, {{business.name}}, with fallbacks like {{contact.firstName|there}}.Create a reusable email template. Body and subject are plain text and support merge tags: {{contact.firstName}}, {{contact.lastName}}, {{contact.fullName}}, {{contact.email}}, {{business.name}}, with fallbacks like {{contact.firstName|there}}.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| subject* | string | — |
| body* | string | — |
email__list_templatesList email templates for this business.List email templates for this business.
| Parámetro | Tipo | Descripción |
|---|---|---|
| includeArchived | boolean | — |
email__list_sendsList recent email sends, optionally filtered to one contact or template. Shows delivery status per send.List recent email sends, optionally filtered to one contact or template. Shows delivery status per send.
| Parámetro | Tipo | Descripción |
|---|---|---|
| contactId | string | — |
| templateId | string | — |
| limit | integer | — |
email__get_send_statsAggregate send counts by status (queued/sent/delivered/opened/clicked/bounced/failed), optionally for one template and/or a recent window. Use to answer 'how did that email do?'Aggregate send counts by status (queued/sent/delivered/opened/clicked/bounced/failed), optionally for one template and/or a recent window. Use to answer 'how did that email do?'
| Parámetro | Tipo | Descripción |
|---|---|---|
| templateId | string | — |
| sinceDays | integer | — |
email__domain__statusCheck the business's custom sending domain: current status, and when it is still pending, exactly which DNS records have not been found yet (record type, host name, and value to add). Calling this also asks the email provider to re-check DNS right now, so it doubles as a manual re-verify. Use whene…Check the business's custom sending domain: current status, and when it is still pending, exactly which DNS records have not been found yet (record type, host name, and value to add). Calling this also asks the email provider to re-check DNS right now, so it doubles as a manual re-verify. Use whene…
No se publicó ningún esquema de entrada para esta herramienta.
email__signature__setSet or clear the CURRENT USER's personal email signature for this business (their Gmail-style sign-off, appended when they compose one-to-one emails from a contact page). ONE-TO-ONE ONLY: marketing campaigns and automation emails never include it, by design; their sign-off is part of the campaign c…Set or clear the CURRENT USER's personal email signature for this business (their Gmail-style sign-off, appended when they compose one-to-one emails from a contact page). ONE-TO-ONE ONLY: marketing campaigns and automation emails never include it, by design; their sign-off is part of the campaign c…
| Parámetro | Tipo | Descripción |
|---|---|---|
| signature* | string | The full signature block, e.g. 'Best, Ross Gray Plyto'. Empty string clears it. |
email__campaign__listList email marketing campaigns with status, type, subject, and audience size. Use to answer 'what campaigns do we have' or find a campaign to edit.List email marketing campaigns with status, type, subject, and audience size. Use to answer 'what campaigns do we have' or find a campaign to edit.
| Parámetro | Tipo | Descripción |
|---|---|---|
| status | string | — |
| limit | integer | — |
email__campaign__getGet one email campaign's full draft: subject, preview text, body, audience, schedule, A/B test setup and (once it has sent) its per-variant results and winner, plus the current eligible-recipient breakdown. Call before editing so changes are targeted, and call it to answer 'which version won'.Get one email campaign's full draft: subject, preview text, body, audience, schedule, A/B test setup and (once it has sent) its per-variant results and winner, plus the current eligible-recipient breakdown. Call before editing so changes are targeted, and call it to answer 'which version won'.
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | — |
email__campaign__createCreate a DRAFT email marketing campaign (never sends anything). Write subject/preview/body in the brand voice; the user reviews in the composer and nothing goes out without an explicit send confirmation. Returns the campaign URL to share with the user.Create a DRAFT email marketing campaign (never sends anything). Write subject/preview/body in the brand voice; the user reviews in the composer and nothing goes out without an explicit send confirmation. Returns the campaign URL to share with the user.
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| campaignType | string | — |
| subject | string | — |
| previewText | string | — |
| bodyMd | string | Markdown body. Merge tags: {{contact.firstName|there}}, {{business.name}}. The unsubscribe footer is added automatically at send. |
| contactListId | string | Omit to target all subscribed contacts. |
email__campaign__updateEdit a draft or scheduled email campaign: name, subject, preview text, body, audience list, schedule, or A/B test. Plyto DOES support A/B testing on email campaigns: set abVariable plus the matching B-side copy and every recipient is assigned a side at send time, then the campaign page reports open…Edit a draft or scheduled email campaign: name, subject, preview text, body, audience list, schedule, or A/B test. Plyto DOES support A/B testing on email campaigns: set abVariable plus the matching B-side copy and every recipient is assigned a side at send time, then the campaign page reports open…
| Parámetro | Tipo | Descripción |
|---|---|---|
| campaignId* | string | — |
| name | string | — |
| subject | string | — |
| previewText | string | — |
| bodyMd | string | — |
| contactListId | string | A list id, or "" to target all subscribed contacts. |
| scheduleType | string | — |
| scheduledAt | string | ISO 8601; required when scheduleType is scheduled. |
| abVariable | string | Run an A/B test on one variable. "subject" tests subjectB against subject, "body" tests bodyMdB against bodyMd, "off" ends the test and sends the A side to eve… |
| subjectB | string | The B-side subject line. Required when abVariable is subject. |
| bodyMdB | string | The B-side body. Required when abVariable is body. |
| abSplitPercent | integer | Percentage of the audience that receives the B side. Defaults to 50 for a straight split. Below 50 holds B back as the challenger. |
automations__createCreate an automation: a trigger + a linear chain of steps. Created in DRAFT and it stays that way. Do NOT activate it as part of building it: tell the user what it does and let them ask for it to be turned on. Steps run in order; a branch step exits contacts that don't match (its false path can be…Create an automation: a trigger + a linear chain of steps. Created in DRAFT and it stays that way. Do NOT activate it as part of building it: tell the user what it does and let them ask for it to be turned on. Steps run in order; a branch step exits contacts that don't match (its false path can be…
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| description | string | — |
| trigger* | object | — |
| exitCriteria | object | Journey-level early exit, checked before EVERY step: a contact who matches leaves the automation immediately. Use for goal completion: billing reminders should… |
| steps* | array | Linear chain, executed in order. |
automations__pausePause an active automation: no new enrollments. In-flight enrollments finish their current step and then hold (W7 executor checks status).Pause an active automation: no new enrollments. In-flight enrollments finish their current step and then hold (W7 executor checks status).
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId* | string | — |
automations__listList automations with status and trigger.List automations with status and trigger.
No se publicó ningún esquema de entrada para esta herramienta.
automations__getFetch one automation with its full step graph (ordered), for inspection or before editing.Fetch one automation with its full step graph (ordered), for inspection or before editing.
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId* | string | — |
automations__connect_stepsRewire the step graph: point a step's `next` or `branch_false` slot at another step (or null to make that path exit). Use after automations.get to see current wiring.Rewire the step graph: point a step's `next` or `branch_false` slot at another step (or null to make that path exit). Use after automations.get to see current wiring.
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId* | string | — |
| fromStepId* | string | — |
| toStepId* | — | — |
| slot | string | — |
automations__list_enrollmentsList enrollments (who's in an automation and where they are), filterable by automation and state.List enrollments (who's in an automation and where they are), filterable by automation and state.
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId | string | — |
| state | string | — |
| limit | integer | — |
automations__get_step_runsStep-by-step execution log for one enrollment: what ran, when, with what outcome/error. The debugging tool for 'why didn't Jane get the email?'Step-by-step execution log for one enrollment: what ran, when, with what outcome/error. The debugging tool for 'why didn't Jane get the email?'
| Parámetro | Tipo | Descripción |
|---|---|---|
| enrollmentId* | string | — |
automations__exit_contactForce-exit an active enrollment: the contact stops at the next step boundary and receives nothing further from this automation. Use when someone asks to be left alone or was enrolled by mistake.Force-exit an active enrollment: the contact stops at the next step boundary and receives nothing further from this automation. Use when someone asks to be left alone or was enrolled by mistake.
| Parámetro | Tipo | Descripción |
|---|---|---|
| enrollmentId* | string | — |
automations__test_runStatic dry-run: validates every step of an automation WITHOUT executing anything: action tools exist and accept their arguments (with templates resolved against dummy values), delays/waits are in bounds, the graph reaches an exit. Run before activate; report problems to the user.Static dry-run: validates every step of an automation WITHOUT executing anything: action tools exist and accept their arguments (with templates resolved against dummy values), delays/waits are in bounds, the graph reaches an exit. Run before activate; report problems to the user.
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId* | string | — |
automations__restoreRestore an archived automation. It comes back PAUSED (never auto-active). Activate it separately to resume enrolling. Previously-exited contacts are not re-enrolled.Restore an archived automation. It comes back PAUSED (never auto-active). Activate it separately to resume enrolling. Previously-exited contacts are not re-enrolled.
| Parámetro | Tipo | Descripción |
|---|---|---|
| automationId* | string | — |
websites__create_siteCreate a WEBSITE: the business's home on the web, multi-section, with a nav. NOT for landing pages: the page an ad sends people to is ads.landing_pages.build, under Marketing, Landing pages. HOW TO BUILD ONE. (1) Call websites.photos first; a site with no photo of the real place, work or people is…Create a WEBSITE: the business's home on the web, multi-section, with a nav. NOT for landing pages: the page an ad sends people to is ads.landing_pages.build, under Marketing, Landing pages. HOW TO BUILD ONE. (1) Call websites.photos first; a site with no photo of the real place, work or people is…
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | — |
| subdomain* | string | — |
| seoTitle | string | — |
| seoDescription | string | — |
| primaryColor | string | Accent color. Defaults to the brand color on file. |
| pairing | string | Font pairing, chosen for the trade. workshop: Barlow Condensed + Inter, sturdy, direct, for trades, contractors, auto, landscaping, anything with a truck. edit… |
| radius | string | How rounded buttons and cards are. sharp for trades and professional services, soft is the default, round for hospitality and consumer. |
| dark | boolean | Dark background. Rare: only when the brand is dark or the owner asks. |
| blocks* | array | — |
websites__list_sitesList this business's websites with status and URLs.List this business's websites with status and URLs.
No se publicó ningún esquema de entrada para esta herramienta.
websites__get_siteGet a site with its theme and every section (block ids, kinds, content) for editing. Call it before any edit so you change the right block, and read the current content back to the person in plain words when they ask what is on the site.Get a site with its theme and every section (block ids, kinds, content) for editing. Call it before any edit so you change the right block, and read the current content back to the person in plain words when they ask what is on the site.
| Parámetro | Tipo | Descripción |
|---|---|---|
| siteId* | string | — |
websites__update_siteChange a site's settings: name, SEO title and description, accent color, font pairing, corner radius, dark or light. Omitted settings keep their value, so 'make it darker' is dark: true and nothing else. Owners can also edit these and every section themselves under Site.Change a site's settings: name, SEO title and description, accent color, font pairing, corner radius, dark or light. Omitted settings keep their value, so 'make it darker' is dark: true and nothing else. Owners can also edit these and every section themselves under Site.
| Parámetro | Tipo | Descripción |
|---|---|---|
| siteId* | string | — |
| name | string | — |
| seoTitle | — | — |
| seoDescription | — | — |
| primaryColor | string | Accent color. Defaults to the brand color on file. |
| pairing | string | Font pairing, chosen for the trade. workshop: Barlow Condensed + Inter, sturdy, direct, for trades, contractors, auto, landscaping, anything with a truck. edit… |
| radius | string | How rounded buttons and cards are. sharp for trades and professional services, soft is the default, round for hospitality and consumer. |
| dark | boolean | Dark background. Rare: only when the brand is dark or the owner asks. |
websites__update_blockEdit part of a section. Pass ONLY the fields that change; everything else in the section is kept, so 'shorten the headline' touches the headline and nothing else. Arrays (items, steps, images) are replaced whole when passed, so to change one service, pass the full items list with that one changed.…Edit part of a section. Pass ONLY the fields that change; everything else in the section is kept, so 'shorten the headline' touches the headline and nothing else. Arrays (items, steps, images) are replaced whole when passed, so to change one service, pass the full items list with that one changed.…
| Parámetro | Tipo | Descripción |
|---|---|---|
| blockId* | string | — |
| content | object | Fields to set or replace. |
| unset | array | Top-level fields to remove. |
websites__add_blockAdd a section to a site, at the end or at a position (0 is the top; later sections shift down). Same shapes and photo rules as websites.create_site. 'Add pricing' means: ask nothing if the prices are on file or in the conversation, otherwise ask for the prices first, then add it.Add a section to a site, at the end or at a position (0 is the top; later sections shift down). Same shapes and photo rules as websites.create_site. 'Add pricing' means: ask nothing if the prices are on file or in the conversation, otherwise ask for the prices first, then add it.
| Parámetro | Tipo | Descripción |
|---|---|---|
| siteId* | string | — |
| block* | object | — |
| position | integer | — |
websites__remove_blockprivilegiadaRemove a section from a site. Do it the moment they ask ('take off the pricing', 'remove the gallery'): photos stay in the library, the section can be added back, and nothing is public until they publish, so never ask 'are you sure'. Confirm first only when it is unclear which section they mean.Remove a section from a site. Do it the moment they ask ('take off the pricing', 'remove the gallery'): photos stay in the library, the section can be added back, and nothing is public until they publish, so never ask 'are you sure'. Confirm first only when it is unclear which section they mean.
| Parámetro | Tipo | Descripción |
|---|---|---|
| blockId* | string | — |
websites__reorder_blocksReorder a site's sections ('move pricing above the FAQ'). Pass the COMPLETE list of block ids in the new top-to-bottom order (websites.get_site returns them). Partial lists are rejected so blocks can't be silently dropped.Reorder a site's sections ('move pricing above the FAQ'). Pass the COMPLETE list of block ids in the new top-to-bottom order (websites.get_site returns them). Partial lists are rejected so blocks can't be silently dropped.
| Parámetro | Tipo | Descripción |
|---|---|---|
| siteId* | string | — |
| blockIds* | array | — |
websites__photosWhat this business can put on a website, newest first: real photos the owner added or attached in chat (what: photo), product screenshots (product-screen), and scenes Plyto generated for ads (generated-scene, hero or about only, and only when nothing real exists). Ad graphics with headlines baked i…What this business can put on a website, newest first: real photos the owner added or attached in chat (what: photo), product screenshots (product-screen), and scenes Plyto generated for ads (generated-scene, hero or about only, and only when nothing real exists). Ad graphics with headlines baked i…
No se publicó ningún esquema de entrada para esta herramienta.
websites__analyze_websiteFetch and analyze an existing website (theirs or a competitor's). Returns title, description, headings, navigation links, and the page's visible text so YOU can rebuild it as a much better Plyto site. Keep the real business facts (services, hours, locations, offers), upgrade the copy and structure.…Fetch and analyze an existing website (theirs or a competitor's). Returns title, description, headings, navigation links, and the page's visible text so YOU can rebuild it as a much better Plyto site. Keep the real business facts (services, hours, locations, offers), upgrade the copy and structure.…
| Parámetro | Tipo | Descripción |
|---|---|---|
| url* | string | — |
websites__check_custom_domainVerify a site's custom domain DNS. If the records point at us, the domain goes active and the site serves on it (TLS is automatic).Verify a site's custom domain DNS. If the records point at us, the domain goes active and the site serves on it (TLS is automatic).
| Parámetro | Tipo | Descripción |
|---|---|---|
| siteId* | string | — |
seo__run_auditRun an SEO + GEO (generative engine optimization) audit on a URL. Fetches the page, robots.txt, sitemap.xml and llms.txt, runs ~15 deterministic checks (title, meta description, headings, alt text, structured data, FAQ content, llms.txt, mobile viewport…), stores the result, and returns the scored…Run an SEO + GEO (generative engine optimization) audit on a URL. Fetches the page, robots.txt, sitemap.xml and llms.txt, runs ~15 deterministic checks (title, meta description, headings, alt text, structured data, FAQ content, llms.txt, mobile viewport…), stores the result, and returns the scored…
| Parámetro | Tipo | Descripción |
|---|---|---|
| url | string | Defaults to the business website. |
seo__list_auditsList recent SEO/GEO audits with scores.List recent SEO/GEO audits with scores.
| Parámetro | Tipo | Descripción |
|---|---|---|
| limit | integer | — |
seo__blog__create_draftSave a blog post draft. YOU write the post (600-1200 words of genuinely useful, non-generic content in the brand voice, markdown with ## headings) and pass it here. Include a meta description (<=155 chars) and 3-6 keywords.Save a blog post draft. YOU write the post (600-1200 words of genuinely useful, non-generic content in the brand voice, markdown with ## headings) and pass it here. Include a meta description (<=155 chars) and 3-6 keywords.
| Parámetro | Tipo | Descripción |
|---|---|---|
| title* | string | — |
| contentMd* | string | — |
| excerpt | string | — |
| seoDescription | string | — |
| keywords | array | — |
seo__blog__listList blog posts (drafts and published).List blog posts (drafts and published).
| Parámetro | Tipo | Descripción |
|---|---|---|
| limit | integer | — |
seo__blog__update_settingsConfigure the automatic blog writer: posts per week (0 disables, max 3), topic list to rotate through, and whether posts auto-publish or wait as drafts. HARD CEILING: 3 posts per week and 10 per day, enforced by the system, no exceptions. When someone asks for more ("120 a week"), do NOT attempt it…Configure the automatic blog writer: posts per week (0 disables, max 3), topic list to rotate through, and whether posts auto-publish or wait as drafts. HARD CEILING: 3 posts per week and 10 per day, enforced by the system, no exceptions. When someone asks for more ("120 a week"), do NOT attempt it…
| Parámetro | Tipo | Descripción |
|---|---|---|
| postsPerWeek* | integer | 0 to 3 only. 0 pauses. Requests above 3 must be clamped to 3 with an explanation, never passed through. |
| topics | array | — |
| autopublish | boolean | — |
booking__pages__listList the business's booking pages with their public URLs, durations, and weekly availability. A booking page is where a lead picks a call time; a booked call automatically qualifies the lead (sales_qualified) and, when the lead came from an ad, reports that qualification back to the ad platform.List the business's booking pages with their public URLs, durations, and weekly availability. A booking page is where a lead picks a call time; a booked call automatically qualifies the lead (sales_qualified) and, when the lead came from an ad, reports that qualification back to the ad platform.
No se publicó ningún esquema de entrada para esta herramienta.
booking__pages__createCreate a booking page and return its public URL, ready to share, link from the website, or put in a form's thank-you message. Availability is weekly windows in 24h HH:MM, keyed by weekday number (0=Sunday..6=Saturday). Times are in the page timezone (default America/Los_Angeles). Example availabili…Create a booking page and return its public URL, ready to share, link from the website, or put in a form's thank-you message. Availability is weekly windows in 24h HH:MM, keyed by weekday number (0=Sunday..6=Saturday). Times are in the page timezone (default America/Los_Angeles). Example availabili…
| Parámetro | Tipo | Descripción |
|---|---|---|
| name* | string | Shown to the booker, e.g. "Intro call" |
| description | string | — |
| durationMinutes | integer | — |
| bufferMinutes | integer | — |
| minNoticeHours | integer | — |
| maxDaysAhead | integer | — |
| timezone | string | — |
| availability* | object | Weekly windows; at least one weekday required. |
booking__bookings__listUpcoming booked calls: who, when, their note, and the show-up task. Use for questions like "what calls do I have" or "who booked this week".Upcoming booked calls: who, when, their note, and the show-up task. Use for questions like "what calls do I have" or "who booked this week".
| Parámetro | Tipo | Descripción |
|---|---|---|
| includePast | boolean | — |
pitches__createGenerate a branded pitch deck: a full slide presentation built from the brand kit (colors, logo, voice, approved claims) and, when a deal/company/contact id is given, grounded in that CRM record — who they are, what the deal is worth. Returns a hosted share link the user sends to their prospect. Ta…Generate a branded pitch deck: a full slide presentation built from the brand kit (colors, logo, voice, approved claims) and, when a deal/company/contact id is given, grounded in that CRM record — who they are, what the deal is worth. Returns a hosted share link the user sends to their prospect. Ta…
| Parámetro | Tipo | Descripción |
|---|---|---|
| brief* | string | What the pitch should accomplish and for whom, in plain language: the offer, the angle, anything the user said about the audience or meeting. The deck grounds… |
| title | string | Deck title. Defaults to the deal/company pairing. |
| dealId | string | Ground the pitch in this deal (pulls its company, contact, and value). |
| companyId | string | Ground the pitch in this CRM company. |
| contactId | string | Ground the pitch in this contact. |
pitches__listList this business's pitch decks with status, share links, and view counts. The honest source for 'has anyone opened the deck'. Status 'generating' means the deck is still building; 'failed' means the build errored and it should be recreated.List this business's pitch decks with status, share links, and view counts. The honest source for 'has anyone opened the deck'. Status 'generating' means the deck is still building; 'failed' means the build errored and it should be recreated.
No se publicó ningún esquema de entrada para esta herramienta.
pitches__edit_slideprivilegiadaEdit one slide of an existing pitch deck with an AI rewrite that keeps the deck's design. The share link updates instantly. Use when the user wants to tweak a deck: change wording, adjust a slide's angle, fix an error. Charges a small AI credit amount.Edit one slide of an existing pitch deck with an AI rewrite that keeps the deck's design. The share link updates instantly. Use when the user wants to tweak a deck: change wording, adjust a slide's angle, fix an error. Charges a small AI credit amount.
| Parámetro | Tipo | Descripción |
|---|---|---|
| deckId* | string | The pitch deck to edit. |
| slideNumber* | integer | Which slide to change, 1-based. Get the order from pitches.list or the deck itself. |
| instruction* | string | What to change on that slide, in plain language (rewrite the headline, soften the pricing framing, swap the layout emphasis). One slide per call. Never instruc… |
pitches__deleteprivilegiadaDelete a pitch deck permanently. Its share link stops working immediately. Two-step: first call returns the deck title to confirm with the user; call again with confirm:true to delete (the same two-step as deleting a deck in the UI).Delete a pitch deck permanently. Its share link stops working immediately. Two-step: first call returns the deck title to confirm with the user; call again with confirm:true to delete (the same two-step as deleting a deck in the UI).
| Parámetro | Tipo | Descripción |
|---|---|---|
| deckId* | string | The pitch deck to delete permanently. |
| confirm | boolean | Must be true to actually delete. Call WITHOUT it first: the tool returns the deck's title so you can confirm with the user. Set true only after the user approv… |
172 de 172 herramientas publicaron una descripción.
Los nombres y descripciones de las herramientas los escribe el publicador y se muestran literalmente como texto inerte. Son las cadenas que un cliente MCP pasa al modelo, así que Forge las analiza en busca de patrones de inyección de prompts — cualquier hallazgo aparece junto al análisis de seguridad de arriba. «Privilegiada» es una coincidencia de palabra clave en el nombre de la herramienta, no una auditoría de lo que hace: un nombre inofensivo puede hacer cualquier cosa.
AI that makes and runs your Google and Facebook ads from your own account, with a CRM behind it.
+ 132 más observadas en esta entrada.
Los nombres enlazados abren el índice de Forge con todas las entradas que se observó que exponen esa herramienta. Ver todas las herramientas indexadas.
Esta entrada no publica ningún paquete de npm, así que Forge no tiene un árbol de dependencias para ella. Es una carencia de cobertura, no una afirmación de que no tenga dependencias.