Help
1. Getting started
- Sign up: choose a username and password on the sign-up page and your account is created right away (a recovery email is optional).
- Sign in with Google: choose “Continue with Google” on the sign-in or sign-up page to start without a username and password. The first time, your account is created after a consent screen (the username is assigned automatically and can be changed once). Existing username accounts are never linked automatically, even if the email matches — to add Google to an existing account, sign in and choose “Link Google account” on My account. Google-only accounts can set a password on My account to also sign in with a username.
- Consent: when you sign up, you accept the Privacy Policy and the Terms of Service (which include the YouTube Terms of Service) and confirm that you are 14 or older. If the documents change, we ask again at your next login.
- Recovery codes: right after sign-up we show ten one-time recovery codes, once. Write them down somewhere safe. If you forget your password, use password reset with your username and one code to set a new password (that code is then used up). On the My account page you can generate new codes after re-entering your password.
- Connect channels: on the Channels page, choose “Connect a channel” and pick the channel to upload to (brand accounts included) on Google’s consent screen. You can connect several channels, even from different Google accounts, and give each a nickname. A YouTube channel can belong to only one account on this service.
2. Scheduling a video
- On the Schedules page, choose New upload.
- Pick a video file and it starts uploading right away (mp4, mov or webm, up to 20 GiB). Large files are sent in chunks and resume automatically if the connection drops. If you closed the page, pick the same file again to continue where it stopped.
- Thumbnail (optional, JPG or PNG): custom thumbnails work only on channels verified by YouTube. Shorts may not show the thumbnail in the YouTube app.
- Channel and details: choose the channel and enter the title (up to 100 characters), description, tags, category and language. You must choose whether the video is made for kids and whether it contains altered or synthetic content. Everything is sent to YouTube exactly as entered; anything over a limit is rejected rather than cut, so you can fix it.
- Visibility and time: choose the visibility and the time. Enter the time in your computer’s time zone; the server stores it in UTC (up to 14 days ahead).
- Review screen: check the summary, tick “The content complies with the Community Guidelines” and press the schedule button. Nothing is scheduled without this confirmation.
All users share the YouTube quota, so when it runs out, uploads move to the next attempt time.
3. Job status
- Waiting
- Waiting for the scheduled time. You can cancel it.
- Postponed
- Moved because of the quota or a channel limit. The next attempt time is shown, and you can still cancel it.
- Uploading
- Being sent to YouTube right now.
- Uploaded
- Done. Open the YouTube link to check it.
- Failed
- The upload did not go through. The reason is shown next to it.
- Needs checking
- It is unclear whether the upload went through, so it is not sent again to avoid duplicates. Check your channel in YouTube Studio and tell the operator if needed.
- Expired
- It could not be uploaded before the deadline. The file has been deleted.
- Canceled
- You canceled it, or the channel was disconnected.
4. Connecting an upload tool (personal API tokens)
Issue a token on the API tokens page and your own upload tool can submit jobs for your account. A token can upload only to the channels of the person who issued it, and the tool must submit only videos you approved yourself. The token is shown once when issued and can be revoked at any time.
Request formats and examples are in the developer API docs.
5. Analytics
On the Analytics page (/app/analytics), pick a connected channel to see the following. The data is read from YouTube API Services and shown only to you.
- Channel overview: subscribers, total views and video count (scope
youtube.readonly). - Period performance (last 7, 28 or 90 days): a chart of daily views and watch time, top videos, traffic sources, viewer age and gender shares, countries and devices (scope
yt-analytics.readonly). Analytics data arrives about a day late, so figures run through yesterday. - Recent videos: views, likes, comment counts and visibility of your latest uploads.
- Bulk reports: choose “Turn on bulk reports” and YouTube starts producing daily reports; the Service fetches the latest one and keeps only a summary (original files are not stored).
Results are cached for at most 24 hours and never kept longer than 30 days. They are deleted immediately when you disconnect the channel or delete your account. If a channel card shows “More access needed”, reconnect that channel and allow reading statistics and analytics on Google’s consent screen.
To use the same data from your own tools, issue a token with Read statistics and analytics (analytics:read) checked on the API tokens page and call GET /api/v1/channels/{connection id}/overview, /videos, /analytics?metrics=&dimensions=&start=&end= and /reports. Only metrics and dimensions from a fixed list are accepted, and the period can be at most 365 days.
Connecting a device (straight from your tool)
When your upload tool shows a connection code (for example ABCD-EFGH), enter it at /link, check the tool name and requested access, and choose “Approve”. The tool then collects an API token for this account once (listed as “Device connection” on the API tokens page; revoke it any time). If you didn’t start the request, choose “Deny”.
6. Deleting your data
- Disconnect one channel: “Disconnect” on the Channels page revokes and deletes the Google token and cancels that channel’s pending jobs.
- Delete everything: “Delete account” on the My account page deletes your connections, tokens, files and account information. You can download a JSON copy with “Export my data” first.
- Ask by email: write to support@toolulah.com with your username. Requests are handled within 7 days.
- Disconnect social accounts (Instagram, Facebook, Threads, TikTok): press “Disconnect” on the Social accounts page, or remove this service under “Apps and websites” (Instagram), “Business integrations” (Facebook) or “Website permissions” (Threads) in that app’s settings. The access token and connection are deleted right away. See Disconnecting social accounts and deleting data.
See the deletion policy in the Privacy Policy for the exact timelines.
7. Revoking Google access
- Go to https://myaccount.google.com/permissions.
- Select toolulah Upload in the list.
- Remove its access.
After that, the Service can no longer upload to that channel. To use it again, reconnect the channel on the Channels page.
8. Contact
박세준 · support@toolulah.com