Create or Update LinkedIn Message Ad
create_update_linkedin_message_adCreate a new or update an existing LinkedIn Message Ad on the Metadata platform.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"senderId": "<senderId>",
"senderName": "<senderName>",
"headlineText": "<headlineText>",
"messageText": "<messageText>",
"actionText": "<actionText>"
},
"name": "create_update_linkedin_message_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Existing Message Ad ID — include to UPDATE; omit to CREATE. | |
| name | Yes | Ad name in the platform library (max 50 characters). | |
| senderId | Yes | LinkedIn sender ID. MUST come from get_linkedin_senders. Do not invent. | |
| actionText | Yes | Call-to-action button label (max 20 characters). | |
| senderName | Yes | Display name matching senderId, also from get_linkedin_senders. | |
| messageText | Yes | Message body (max 2000 characters). Supports LinkedIn personalization macros — ONLY %FIRSTNAME%, %LASTNAME%, %COMPANYNAME%, %JOBTITLE%, %INDUSTRY%. Any other %...% token is rejected by the platform validator. | |
| headlineText | Yes | Message subject line shown in the recipient's inbox (max 60 characters). | |
| completionStatus | No | Defaults to DRAFT. Use COMPLETED only when every required field is final. | |
| bannerCreativeLibraryId | No | Optional: imageLibraryId of the banner image shown above the message. Upload the image first via upload_image_creative and pass the returned ID. Omit to skip the banner. |