Documentation Index
Fetch the complete documentation index at: https://help.hivra.app/llms.txt
Use this file to discover all available pages before exploring further.
Hivra connects to X (formerly Twitter) through X’s official authorization flow. Once your account is linked, you can include X as a destination in the Hivra Composer. Each post consists of tweet text drawn from your caption and the video you uploaded — X does not offer per-video privacy levels in the same way as YouTube or TikTok, so posts are public by default on your timeline.
Connect your X account
Open Integrations
In Hivra, go to Dashboard → Integrations and click the X tile.
Confirm the redirect
Review the confirmation overlay showing your workspace and the Hivra callback URL, then click Continue.
Authorize in X
You are redirected to X’s authorization page. Accept all requested permissions — these cover posting tweets with media on your behalf. Declining any scope prevents the connection from completing.
Verify the connection card
After the redirect returns you to Hivra, your X handle and profile picture appear on the integration card. The health chip reads Healthy once the monitoring job confirms the token is valid.
X publishes posts to your public timeline. There is no API-level option to post privately or restrict who sees a post beyond the reply settings described below.
X publish settings
When you add X as a destination in the Composer, a settings panel appears with the following options.
The Tweet text field is populated from the Composer’s shared caption by default. X displays this text alongside your video on the timeline. Keep in mind X’s character limit when writing your caption — if the shared caption exceeds the limit, use the per-platform caption override to write a shorter version specifically for X.
The video you uploaded in the Composer is automatically attached to the post as the media. Hivra uploads the video file to X’s media endpoint before creating the tweet. No additional configuration is needed for the media attachment.
To write a different tweet text specifically for X, enable Override caption in the X settings panel and enter your X-specific text. This is useful when your shared caption is too long for X’s character limit or when you want platform-specific copy, hashtags, or mentions on X.
Hashtags and @mentions in your X caption are hyperlinked automatically. Use the per-platform override to include X-specific hashtags that are not relevant to your other destinations.
Reconnect your X account
If the integration card shows Attention, your X token has expired or been revoked.
Open Integrations
Go to Dashboard → Integrations and locate the X card.
Click Reconnect
Click Reconnect on the card to restart the OAuth flow.
Re-authorize in X
Accept all permissions on X’s authorization page to issue a fresh token.
Confirm the health chip
Wait for the monitoring job to run. The chip should return to Healthy within a few minutes.
Changing your X account password or revoking app access from X’s Settings → Security and account access → Apps and sessions will invalidate your Hivra token immediately. Reconnect from the Integrations page after any such change.
