---
title: "create_update_convo_ad. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/create_update_convo_ad
description: "Create or update a LinkedIn Conversation Ad (\"convo ad\") — a branching in-message chat where each step contains a message bubble and a list of button actions that drive the conv… Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# create_update_convo_ad

Create or update a LinkedIn Conversation Ad ("convo ad") — a branching in-message chat where each step contains a message bubble and a list of button actions that drive the conv…

Destructive [creative](https://metadata.io/developers/tools/#cat-creative)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `id` | integer |   | Existing convo ad ID — include to UPDATE; omit to CREATE. |
| `name` | string | required | Ad name in the platform library (max 50 chars). |
| `senderId` | string | required | LinkedIn sender ID. MUST come from get_linkedin_senders. |
| `senderName` | string | required | Display name matching senderId from get_linkedin_senders. |
| `headlineText` | string | required | Subject line shown above the message thread. |
| `bannerCreativeLibraryId` | integer |   | Optional: imageLibraryId of the banner image. Upload first via upload_image_creative. |
| `completionStatus` | string |   | Defaults to DRAFT.one of: `DRAFT`, `COMPLETED` |
| `flowId` | integer |   | LinkedIn convo flow version. Defaults to 7 — keep the default unless told otherwise. |
| `templateId` | integer |   | LinkedIn convo template ID. Defaults to 1 — keep the default unless told otherwise. |
| `steps` | array | required | Ordered list of conversation steps. MUST include stepId=1 as the entry. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other creative tools:

- [archive_ad](https://metadata.io/developers/tools/archive_ad) Destructive
- [create_update_carousel_ad](https://metadata.io/developers/tools/create_update_carousel_ad) Destructive
- [create_update_document_ad](https://metadata.io/developers/tools/create_update_document_ad) Destructive
- [create_update_google_ads_ad](https://metadata.io/developers/tools/create_update_google_ads_ad) Destructive
- [create_update_image_ad](https://metadata.io/developers/tools/create_update_image_ad) Destructive
- [create_update_linkedin_message_ad](https://metadata.io/developers/tools/create_update_linkedin_message_ad) Destructive
- [create_update_microsoft_ads_ad](https://metadata.io/developers/tools/create_update_microsoft_ads_ad) Destructive
- [create_update_video_ad](https://metadata.io/developers/tools/create_update_video_ad) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)