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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | The day it goes out, YYYY-MM-DD, inside the campaign's window and not in the past. | |
| lane | Yes | Where it goes. | |
| 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. |