States
The status decides which call is allowed. Any other call returns 409 conflict.
| Status | Allowed |
|---|---|
draft | PATCH, generate |
generating | Wait. Poll GET /automations/{id}. |
review | Read posts, launch |
launched | extend, pause, cancel |
paused | resume, cancel |
Create
cadence is postsPerDay, days, startDate, times and timezone. Default: one post a day for seven days from tomorrow. tiktokMode: "inbox" sends every TikTok post to the inbox without a caption, which is a safe first run. Edit with PATCH while in draft only.
Request
curl -X POST "https://looptake.com/api/v1/automations" \
-H "Authorization: Bearer $LOOPTAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "September daily",
"cadence": { "postsPerDay": 1, "days": 30, "startDate": "2026-09-01", "times": ["15:00"], "timezone": "Europe/Lisbon" },
"selectedAccounts": { "tiktok": ["ff9d429b-07c5-4320-a98c-ac6e1791b828"] },
"tiktokMode": "inbox"
}'Generate and review
generate writes one post per slot and moves the run to review. It publishes nothing. GET /automations/{id}/posts is the review queue; these posts do not appear in GET /generations.
Generate, review, launch
# Fill every slot. Returns 202; poll until the status is review.
curl -X POST "https://looptake.com/api/v1/automations/4ecde50a-7af3-43b9-b66e-a36422c7e51f/generate" \
-H "Authorization: Bearer $LOOPTAKE_API_KEY"
# Review the batch.
curl "https://looptake.com/api/v1/automations/4ecde50a-7af3-43b9-b66e-a36422c7e51f/posts" \
-H "Authorization: Bearer $LOOPTAKE_API_KEY"
# Schedule all of it.
curl -X POST "https://looptake.com/api/v1/automations/4ecde50a-7af3-43b9-b66e-a36422c7e51f/launch" \
-H "Authorization: Bearer $LOOPTAKE_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"Launch
launch schedules every post in the run. Send an Idempotency-Key so a retry cannot schedule the month twice.
After launch
extendadds days at the same rhythm, with no gap.pauseholds unpublished posts;resumereleases them.cancelcancels every post not yet published. Published posts stay.
See Automations for the product view, and the reference for every field.