clip-uploader

Raw files

    Run job

    
  
    

    


    
  
    
    
    Job history
    
    
    
    
      
    idtypestatuscreatedlast line
    
      
    
    
  
    
  
    
    
    Job log
    
    
    
  
    

    


    
  
    
    
    Outputs
    
    
    
      
      
    
    
    
    
  
    
  
    
    
    Preview
    
    
    
    
  
    

    


    
  
    
    
    Settings
    
    
    
      
      
      
    
    
    
    
    
    
    
  
    

    


    
  
    
    
    Connection
    
    
    
    
  
    

  
    
    
    Caption packs
    
    
    A caption pack is a JSON file with ~20 caption variations + hashtags for a series/movie. Tag a batch below with one so captions rotate randomly instead of using the filename.
    
    
    
    
    
      
      
    
    
    
    
    
    
  
    

  
    
    
    Batches
    
    
    Only batches tagged with a caption pack are picked up by the scheduler. Once every clip in a tagged batch is published, its files are deleted from the server automatically.
    
    
    
    
      
    typesourceprogresscaption packaction
    
      
    
    
  
    

  
    
    
    Smart Schedule
    
    
    Auto-publishes one clip per posting time, only from batches tagged with a caption pack above, with a random delay so timing doesn't look robotic.
    
    
    
      
      
      
      
      
    
    
    
    
    
    
    
  
    

  
    
    
    Publish history
    
    
    
    
      
    whentypesourcefilestatusdetail
    
      
    
    
  
    

  
    
    
    
      One-time setup checklist (only needed once)
      
      
        
    1. Your Instagram account just needs to be Business or Creator — no Facebook Page required for this track.
      2. 
        
    2. Go to developers.facebook.com → your Meta App → Use cases → Customize "Manage messaging & content on Instagram".
      3. 
        
    3. Under "Add required permissions", go to Permissions & features and add instagram_business_basic and instagram_business_content_publish.
      4. 
        
    4. Under "Generate access tokens", click Add account to connect your Instagram account as a tester for this app.
      5. 
        
    5. Under Facebook Login for Business → Settings, add <PUBLIC_BASE_URL>/auth/instagram/callback to Valid OAuth Redirect URIs.
      6. 
        
    6. Copy the Instagram app ID + secret (shown on that use-case page — not the main Meta App ID) into webapp/.env as INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET, plus PUBLIC_BASE_URL.
      7. 
        
    7. Restart the webapp so it picks up .env, then click Connect Instagram above.
      8.