Twitter

Twitter/X integration allows Errand agents to post tweets on your behalf during task execution. When connected, an agent can compose and publish tweets as part of completing a task.

Prerequisites

• An X/Twitter Developer account (developer.x.com)
• A Developer App with Read and Write permissions

Step 1: Create or configure your X Developer App

1. Go to the X Developer Portal
2. Navigate to your Projects & Apps dashboard
3. Create a new app or select an existing one

Step 2: Set app permissions

1. In your app settings, go to User authentication settings
2. Set App permissions to Read and Write
3. Save your changes

Caution

If you change permissions on an existing app, you must regenerate your Access Token and Secret for the new permissions to take effect.

Step 3: Generate API credentials

1. In your app settings, navigate to Keys and Tokens
2. Generate (or regenerate) the following credentials:
   • API Key (also called Consumer Key)
   • API Secret (also called Consumer Secret)
   • Access Token
   • Access Token Secret
3. Copy all four values immediately — some are only shown once

Step 4: Enter credentials in Errand

1. Open the Errand UI and go to Settings > Integrations
2. Find the Twitter/X card and click it
3. Enter all four credentials:
   • API Key
   • API Secret
   • Access Token
   • Access Token Secret
4. Click Test & Save

Errand verifies the credentials against the Twitter API before saving. If verification fails, double-check that you copied the values correctly and that your app has Read and Write permissions.

How it works

• When an agent needs to post a tweet during task execution, it uses your stored credentials to publish via the X API
• All credentials are encrypted at rest using your Errand credential encryption key
• Tasks that use Twitter are automatically tagged with media and post

Troubleshooting

Issue	Solution
”Invalid credentials” error on save	Regenerate your keys and tokens in the X Developer Portal and re-enter them
”Read-only” or “Forbidden” error	Your app permissions are set to Read only — change to Read and Write and regenerate tokens
Tweet fails with rate limit error	The X API enforces posting limits — wait and try again, or check your app’s rate limit status in the Developer Portal
Credentials not saving	Ensure all four fields (API Key, API Secret, Access Token, Access Token Secret) are filled in