---
title: "create_update_document_ad. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/create_update_document_ad
description: "Create a new or update an existing LinkedIn Document Ad on the Metadata platform. Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# create_update_document_ad

Create a new or update an existing LinkedIn Document Ad on the Metadata platform.

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

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `id` | integer |   | Existing Document Ad ID — include to UPDATE; omit to CREATE. |
| `name` | string | required | Ad name in the platform library (max 50 characters). |
| `libraryId` | integer | required | Integer id of the DOCUMENT creative in the library (contentType=DOCUMENT). Get it from search_library_creatives_by_name(contentTypes="DOCUMENT"). NOT an image/video id. |
| `headline` | string | required | Headline shown with the document (max 200 characters). |
| `text` | string | required | Introductory text shown with the document (max 3000 characters). |
| `ctaType` | string |   | Call-to-action. Defaults to UNLOCK_FULL_DOCUMENT (the document-gate CTA).one of: `UNLOCK_FULL_DOCUMENT` |
| `maxPreviewPages` | integer |   | How many document pages are previewable before the unlock gate. Defaults to 1. |
| `completionStatus` | string |   | Defaults to DRAFT. Use COMPLETED only when every required field is final.one of: `DRAFT`, `COMPLETED` |

## 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_convo_ad](https://metadata.io/developers/tools/create_update_convo_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)