The posting plan
Put videos on the calendar. Posting stays in the app.
Profiles
curl https://getuser.app/api/v1/profiles -H "Authorization: Bearer $GETUSER_API_KEY"Each profile card (id, name, accounts) holds up to one TikTok and one Instagram account (platform, username, display_name, connected). No tokens or stats are returned.
Read the calendar
curl "https://getuser.app/api/v1/plan?from=2026-11-02T00:00:00Z&to=2026-11-09T00:00:00Z" -H "Authorization: Bearer $GETUSER_API_KEY"from and to are ISO times with a zone; left out, the next 30 days. Each item is the video itself: id (the video's id), video_id, profile_id, planned_at, hook_text, format.
Add and remove
curl https://getuser.app/api/v1/plan \
-H "Authorization: Bearer $GETUSER_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "video_id": "6f1c…", "profile_id": "…", "planned_at": "2026-11-02T12:00:00Z" }'Only a finished video can go on the plan. Leave out profile_id to keep the profile of a video already on the plan. Captions are not set through the API yet: the founder writes them when posting, or asks for one with POST /ai/captions.
DELETE /plan/{id} (the video's id) takes it off the calendar. The video stays.
Why the API does not post
TikTok requires the person posting to see the post, pick its privacy and confirm it inside the app, and Getuser's TikTok review is still pending. So the API and agents fill the calendar, and the founder posts from Getuser (or with the app's auto-post, set up in the app). This may change after the review; Changelog will say.