Post a video to TikTok or Instagram from your own account
The post comes from a real phone that is signed in to your own account. Before you start- An Android phone, unlocked, with the TikTok or Instagram app installed and signed in. Pushing media works on Android only. On an iPhone, put the video in the gallery yourself and start at step 2.
- A link to the video file. For a UGC clip made in Appeeky, read the clip with
GET /v1/ugc/clips/:clipIdand use itsvideoUrl. These links are short-lived, so fetch one right before you push. See Personas and clips.
1
Copy the video to the phone
Run
push_media with the link. The video lands in the phone’s gallery.2
Open the app
Run
list_apps to find the app’s id, then open_app with it.3
Walk to the post screen
Repeat observe, then tap: start a new post, pick the newest video from the gallery, continue to the caption screen. Each tap returns the next screen.
4
Write the caption
Tap the caption field, then run
type with the caption text.5
Tap Post and approve
The tap on Post or Share pauses. Open
/dashboard/phones, check the screenshot and the caption, and choose Approve. The post goes out.phone_* tools step by step and stops at the Post button until you approve.
Hand the whole task to the phone agent
When the media is already in the gallery, let the phone agent do the walking. Push the video first, because the agent itself can’t push media.Check a screen on a real device
observe returns a real screenshot from a real phone, so an agent can look at things that only exist on a device: how your app looks after an update, or which screen a flow ends on.
phone_tap and reads each screen. Nothing in this flow needs approval unless a button it taps is labelled like Buy or Subscribe.
Tips for reliable runs
- Unlock the phone and keep the screen on before you start.
- Sign in to the apps yourself. Agents never enter passwords or codes you didn’t give them.
- Name the app, the media and the exact caption.
- Stay close to the dashboard or your email. An approval expires after 10 minutes.
- Keep an eye on the rate limit in long sessions: 30 actions per minute and 600 per hour for each phone.

