Add a post
add_postAdd a post to a campaign on one lane and day, as Promo's + does, with its words, the angle they take and a picture or video from the Library if you have them. It is a post on its own, not part of a moment, and a draft until it is scheduled. For more than one post, or the same post on several lanes, add_posts does it in one call.
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": {
"campaign_id": "<campaign_id>",
"lane": "<lane>",
"date": "<date>"
},
"name": "add_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | The day it goes out, YYYY-MM-DD, inside the campaign's window. A draft may be saved with a day gone by; Schedule asks for one still ahead (schedule_check says so). | |
| lane | Yes | Where it goes. | |
| test | No | The test this post is a variant of, or null to take it out: collab_starter (artist or audora: Who starts the Collab: the artist's post with Audora invited, or Audora's post with the artist invited). Audora pools each variant's posts at day 7 and calls the test once each variant has enough posts and one is clearly ahead; Admin shows the reading. | |
| time | No | The time it goes out, HH:MM 24-hour, in the artist's own time zone. | |
| angle | No | Which of Audora's post angles the words take (the key names it: listener_pov is the listener's side of the song, tail_section a part of the track no other post used, hook_object an object the song names, and so on). Audora counts how each angle does for the artist, and promo_results' what_works shows the result. get_campaign shows each post's angle. | |
| artist | No | Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection. | |
| caption | No | The words of the post, as they will be published. The lane's limit and Audora's text rules apply (no placeholders, nothing that points back at another post). | |
| dry_run | No | True to check the call and see what it would do, without writing anything. | |
| hashtags | No | Up to 12 hashtags, with or without #. Replaces the list. | |
| link_url | No | A web address the post links to, or null to remove it. | |
| campaign_id | Yes | From list_campaigns. | |
| media_asset_id | No | A picture (for a picture post) or a video (for a video post) already in the artist's Library, by its media asset id. Audora does not make pictures or videos through this connection. | |
| idempotency_key | No | Send the same key if you retry, and the change happens once. |