01-create-twitter-app.md

back to README.md

Create a twitter app

You can create a twitter app for your twitter account at https://developer.twitter.com/en/apps.

If you haven’t yet, you will be asked to apply for a Twitter developer account. See my answers below for reference. If you’ve done that before, skip the next section and continue at Create an app.

Apply for a developer account

You might be asked to add a phone number to your twitter account before proceeding. If the phone number is used in another account, it won’t let you use it again. But you can remove the phone number from the other account. You can change it back once your developer account was approved.

Your twitter account will also need to be associated with an email address. If it isn't yet, set the email address in your twitter account email settings.

What is your primary reason for using Twitter developer tools?

When in doubt, select: Hobbyist -> Making a bot

Describe in your own words what you are building

1. In your words

This app will be used to publish tweets using the twitter-together GitHub Action. It allows to use a GitHub repository and pull request reviews as a workflow to collaboratively tweet from a shared twitter account.

2. Are you planning to analyze Twitter data?

No

3. Will your app use Tweet, Retweet, like, follow, or Direct Message functionality?

Yes. This app will be used to publish tweets for this account. It might be used for retweeting in future. There are no plans for liking.

4. Do you plan to display Tweets or aggregate data about Twitter content outside of Twitter?

No twitter data will be displayed. The twitter-together GitHub action shows a preview of the tweet before it is published and becomes twitter data.

Will your product, service, or analysis make Twitter content or derived information available to a government entity?

No

---

You will receive an email to verify your developer account. After that you can create an app at https://developer.twitter.com/en/portal/apps/new.

Create an app

Only 4 questions are required. Here are my answers for reference

App name (required)

<your twitter account name>-twitter-together, e.g. probot-twitter-together

Application description (required)

Collaboratively tweet using GitHub’s pull request review process by utilizing the twitter-together GitHub Action.

Website URL (required)

https://github.com/twitter-together/action

Tell us how this app will be used (required)

This app will be used to create tweets that have previously been reviewed and accepted on our GitHub repository. It allows everyone to submit a tweet draft that we can discuss prior publishing.

Save credentials

"read and write" permissions are required. When you have created your app, open app settings and set app permissions to "Read & Write". If you change the permission you must re-generate tokens for the change to take effect.

Open your app’s "Keys and tokens" tab. In the "Access token & access token secret" section, press the "Create" button. After that you will see all four credentials required for twitter-together.

Now save the credentials into your repository’s "Secrets" settings as follows

Twitter Credential name	GitHub Secret name
API key	TWITTER_API_KEY
API secret key	TWITTER_API_SECRET_KEY
Access token	TWITTER_ACCESS_TOKEN
Access token secret	TWITTER_ACCESS_TOKEN_SECRET

---

next: Create a .github/workflows/twitter-together.yml file