How to setup the X API Key

In this article, we will cover:

• What is changing with X (formerly Twitter) and why
• How to setup the X API Key with X
  
  • How to create an X Development Account
  • How to create an app and API Key
• How to setup the X Integration with TINT
• Re-authorize existing X accounts in TINT (optional)
• FAQs
  • What happens if you don't want to continue to use X due to this change?  
  • I subscribed to the Basic plan. How many tweets can I ingest?
  • When I try to add or reauthorize a Twitter social account, the popup opens but is blank
    • To check the redirect URL
    • For the wrong information on the Twitter Integration
  • When trying to resolve my twitter account, I get the following error:
    {"errors":[{"status":"403","code":"403","title":"Forbidden","detail":"Nil JSON web token"}]}
    • Standalone App instead of in a Project
    • Regenerating the API Keys
  • When I try to publish, the post is accepted by publishing doesn't work.
  • I have an existing Twitter app, can I re-use it?
  • I have Twitter Enterprise, can we provide those credentials to you?
  • How can I limit the number of tweets Twitter sends so that I can maximize the 10,000 tweets I have access to?

  • I didn't save or I have lost the API v2 and/or API v1.1 information and the integration doesn't work, how do I get back to it?

  • How to move your App to from Staging or Development to Production?

What is changing with X (formerly) and why

X has made an API change that will impact your access to content. There’s still a lot of great content on X, and we have a solution to ensure your continued access.

What this means to you:

To continue sourcing new content from X, you will need to sign up for an X developer account and complete a few simple steps in the TINT platform before June 1, 2023. The changes only take a few minutes when you follow the step-by-step instructions here.

The X Basic Developer account has a monthly subscription cost of $175-200 per month (annual or monthly dependant) and gives you the benefit of being more in control of content because it’s your app.

Please note that the basic developer account is needed in order to ingest X content, the free tier does not include content ingestion.

How to setup the X API Key with X

In order to be able to enter API Key Credentials inside TINT, you will first need to generate the API keys.  In order to generate keys, you will need to have an X Development Account.

 

How to create an X Development Account

Visit https://developer.twitter.com/en to create an X Developer Account (if you don’t already have one).

Once, you have landed on this page, most users will only need the Basic plan, click “Subscribe” to sign up but if you need more usage than the Basic Plan offer, please look at the Pro plan or apply for Enterprise.

Once you have created an account, X will ask you to agree to its developer policy. 

Here it will ask you to describe your use case(s) for the X's data and how you will use the API 

For example: My intention is to utilize the X API for my personal account. The intended use cases would involve scheduling my tweets, responding to replies, and analyzing my tweet performance. The analysis would encompass the impressions or engagements garnered by my tweets from other users. Please note that I require this API key for my personal usage only.

We suggest you write out your own description, but can take inspiration from the example above.

Usually, you are automatically approved. Check your email to verify your developer account. Look for an email from developer-accounts@twitter.com that has the subject line: "Verify your X Developer Account". Once you’ve done this step, you’ll be taken to your X Developer account. 

How to create an app and API key 

1. 1. From the initial Dashboard, click the blue cog. It is located in the middle of the page, under your default product.
      
      
   2. Click the “Set Up” button found under User authentication settings.
   3. In the App permissions section, select Read and write.
   4. In the Type of App section, select “Web App, Automated App or Bot.”
   5. In the App info section, set the callback URI to https://api.tintup.com/v2/accounts/twitter and set the Website URL to your company’s website URL.
   6. The following screen will display OAuth 2.0 details.  Save this information for use in TINT
   7. You will be navigated back to the main screen, with the authentication section at the bottom now completed.
   8. Navigate to the “Keys and tokens” tab, found at the top of the page.
   9. Make sure that the environment is set as Production.  If it's not, click here to see how to change this
      
   10. Click on Generate/Regenerated under Consumer Keys section.
   11. The next screen will have the APIv1.1 id and secret. Save this information for use in TINT.

 

How to setup the X Integration with TINT

1. 1. Navigate to your name in the right-hand corner
   2. Click on Team Settings
   3. On the left-hand side, click on Integrations in the list
   4. Click on +Add
   5. Select X and click Connect
   6. Enter the previously saved Client ID and Secret for API v2 
   7. Enter the previously saved Client ID and Secret for API v1.1

Once completed, you are now ready to ingest Tweets and/or Schedule Tweets. 

Re-authorize existing X accounts in TINT 

Prior to the switchover on May 31, 2023, we will send emails noting that existing X tokens will begin to expire. If you already have social feeds associated with an X account in TINT, it might be a good time to reauthenticate so you don’t have any lapse in content ingestion when the switchover happens.

To do this:

1. Navigate to your name in the right-hand corner
2. Click on Team Settings
3. On the left-hand side, click on Social Accounts in the list
4. Filter by X at the top of Social Account section
5. Click on ... and click on re-authorize in the dropdown menu
6. Once clicked an oAuth window will appear, if you are logged in, your username will be in the top right.  If not, log in with the correct details for the X account that you are re-authorizing and click Authorize App to continue.
7. Complete this action with all your existing X accounts found in this list.

FAQs 

What happens if you don't want to continue to use X due to this change?

Any X content ingested before June 1, 2023, will remain available if you leave the feed on the TINT board. The feed will stop pulling content on June 1.   

I subscribed to the Basic plan. How many tweets can I ingest?

Up to 15,000 per month. The actual count may be less if you use X right requests as we need some make some requests to check their statuses. X actually limits apps to 60 requests of up to 100 tweets per 15 minutes so that means we support up to 60 Twitter social feeds. 

When I try to add or reauthorize an X social account, the popup opens but is blank.

This likely is happening because either the redirect URL entered is incorrect or the X Integration has the wrong information in it.

To check the redirect URL:

Go into X's Developer Portal by clicking on your app under Products & Apps and clicking on the Edit button under User authentication settings. The redirect URL should be https://api.tintup.com/v2/accounts/twitter.

For the wrong information on the X Integration:

There are a few indicators, some of which you can see for yourself on the Integration page on TINT once you have added your Integration.

This is what a working X integration looks like on TINT:

This shows the API v2 ID and API v1.1 ID which is what you put in box 1 and box 3 on the connection popup. 

• The API v2 normally ends in pjaQ

• The API v2 is always longer than the API v1.1

If you see the following - you have put the API v2 twice by accident

If you see the following - you have swapped the API v1.1 and API v2 around:

If you see the following - you have entered the secret key in the ID boxes:

If you see the following - you have the app but it's not configured correctly inside Twitter:

To configure the app from this point:

Go back to the section on - How to create an app and API key

Though even if the integration looks correct on TINT, we are unable to see your secret keys as they are like passwords so if you have entered these incorrectly, the integration will not work.

When in doubt, delete the integration and start again.

When trying to resolve my X account, I get the following error:
{"errors":[{"status":"403","code":"403","title":"Forbidden","detail":"Nil JSON web token"}]}

Standalone App instead of in a Project

One of the reasons why this occurs is that the app has been made as a standalone app instead of an app under a project.  It would see it under the section of Standalone Apps.  

It would look like this: 

1. Go to the X's Developer Portal: Use Cases, Tutorials, & Documentation .
2. Sign in to your account.
3. Click on the Projects & Apps tab.
4. Click on the Projects tab.
5. Click on the name of the project that you want to add the standalone app to.
6. Click on the Add App button.
7. Select Add an Existing App
8. Pick an App out of the list that you want to add to the project.  It says that you will gain access to v2.
9. Click on the Next button

1. Go to the X's Developer Portal: Use Cases, Tutorials, & Documentation .
2. Sign in to your account.
3. Click on + Add Project
4. Fill in the information for the Project.  Project Name, what your use case is, what you are you going to use the Project for - description
5. Select Add an Existing App
6. Pick an App out of the list that you want to add to the project.  It says that you will gain access to v2.
7. Click on the Next button

There’s no need to delete the X Integration if it’s correct as it will auto-update and you should be able to resolve the X account with no error popping up or this will resolve the feed.  

Regenerated API keys

Another reason why this error occurs if someone regenerates the API v1.1 keys on the X Developer App.  The API keys on TINT would be no longer valid and you would have to delete the integration and re-add the X Integration with the newly generated API keys.

If you run into any issues or have questions regarding X, please don't hesitate to contact Technical Support at support@tintup.com.