RErecurpost

Add a post to a recurring content library

Adds content to a library for evergreen recurring posting; RecurPost publishes it automatically per the library's schedule. Supports per-platform message overrides, media, first comments, and platform-specific options.

post/api/add_content_in_library

Request

  • Base URL
    https://social.recurpost.com
  • Auth
    none declared

Request body

emailidstring email required

RecurPost account email address

pass_keystring required

API Password Key from Account Settings (NOT the login password)

idstring required

Library ID from /api/library_list

messagestring required

Default message/content for the post

is_top_of_queue0 | 1

1 moves the post to the top of the queue on all selected accounts

content_livedatestring date

Keep as draft until this date (YYYY-MM-DD); blank = active immediately

content_expiredatestring date

Stop recurring after this date (YYYY-MM-DD); blank = never expires

image_urlstring[]

Array of publicly accessible image URLs. Must be an array, not a string.

video_urlstring uri

Publicly accessible video URL

urlstring uri

Website URL to share with the post

host_images_on_recurpostboolean

Copy images to RecurPost servers for reliability

fb_messagestring

Facebook-specific message

tw_messagestring

X (Twitter)-specific message

ln_messagestring

LinkedIn-specific message

in_messagestring

Instagram-specific message

gmb_messagestring

Google Business Profile-specific message

pi_messagestring

Pinterest-specific message

yt_messagestring

YouTube-specific message

tk_messagestring

TikTok-specific message

th_messagestring

Threads-specific message

bs_messagestring

Bluesky-specific message

fb_post_type'feed' | 'story' | 'reel'

Facebook post type

in_post_type'feed' | 'story' | 'reel'

Instagram post type

in_reel_share_in_feed'yes' | 'no'

Share Instagram Reel to feed too (only when in_post_type is reel)

first_commentstring

Default first comment (commonly hashtags) for Facebook Pages, LinkedIn, and Instagram feed

fb_first_commentstring

Facebook-specific first comment

ln_first_commentstring

LinkedIn-specific first comment

in_first_commentstring

Instagram-specific first comment (feed only)

ln_documentstring uri

Document URL for LinkedIn carousel (PPT, PDF, DOCX)

ln_document_titlestring

Title for the LinkedIn document

pi_titlestring

Pinterest pin title

gbp_cta'None' | 'Learn more' | 'Sign up' | 'Buy' | 'Order online' | 'Book' | 'Call now' | 'Offer'

Google Business Profile call-to-action button

gbp_cta_urlstring uri

CTA link URL (not used for Call now or Offer)

gbp_offer_titlestring

Offer title (when CTA is Offer)

gbp_offer_start_datestring

Offer start, format Y-m-d H:i:s

gbp_offer_end_datestring

Offer end, format Y-m-d H:i:s

gbp_offer_coupon_codestring

Coupon code for the offer

gbp_offer_termsstring

Offer terms and conditions

gbp_redeem_offer_linkstring uri

URL to redeem the offer

yt_titlestring

YouTube video title

yt_category'Film & Animation' | 'Autos & Vehicles' | 'Music' | 'Pets & Animals' | 'Sports' | 'Travel & Events' | 'Gaming' | 'People & Blogs' | 'Comedy' | 'Entertainment' | 'News & Politics' | 'Howto & Style' | 'Education' | 'Science & Technology' | 'Nonprofits & Activism'

YouTube video category

yt_privacy_status'Public' | 'Private' | 'Unlisted'

YouTube privacy setting

yt_user_tagsstring

YouTube tags, comma-separated

yt_thumbstring uri

Custom YouTube thumbnail URL

yt_video_made_for_kids'yes' | 'no'

YouTube made-for-kids designation

tk_privacy_status'Public to Everyone' | 'Mutual Follow Friends' | 'Self Only'

TikTok privacy setting

tk_allow_comments'yes' | 'no'

Allow TikTok comments

tk_allow_duet'yes' | 'no'

Allow TikTok duets

tk_allow_stitches'yes' | 'no'

Allow TikTok stitches

Response

Request completed successfully

object required

Changes

No recorded changes to this operation across all 1 revision of this API.