Frequently Asked Questions

Developer portal enhancements FAQs

Application process FAQs

Developer portal management FAQs

Premium billing FAQs

 

Dev portal enhancements

There are additional related questions and answers in the FAQ section of the Projects documentation.

I saw an outside resource on how to get started and it looked very different from the process I used to set up?

We have recently launched a new developer portal experience and that might be why things look different than the resource you used to set up. The core functionality demonstrated should be similar, however, if you need any support, let us know on the forums

A Bearer Token is now being provided. Is this new?

Yes, your bearer tokens will automatically be generated alongside your API key, API secret key, and your user tokens (also known as access tokens) when you first create your new App. You can create or regenerate a bearer token using the generator on the "keys & tokens" App settings page. This can be accessed from your dashboard by clicking the key icon next to the App for which you would like to generate a bearer token. Check out our documentation on best practices around keeping your keys and tokens safe. To learn more about generating bearer tokens be sure to check out our documentation on the subject.

Can anyone else see my Project name or information other than me?

Your Project name and description will only be visible to you or your team if you have a team account. It is important to note that if you implement third-party authentication (sometimes referenced as “sign in with Twitter”), your App’s description will be displayed publicly. You should review and update this description before implementing this feature. Be sure to check out our documentation on the subject to learn more.

Can I add existing Apps to a Project?

Yes, you can add an existing App to your new Project. While setting up your Project you should see an option to add any of your standalone Apps. Keep in mind that you may only have one primary or production App per approved use case. See our Developer Policy for more information, including guidelines around additional apps for development or testing.

What if I have more than 10 Apps already? Can I create a Project?

If you have 10 Apps you cannot create a Project unless you delete one of your Apps. Once you’ve deleted your App and created a Project you can try the new v2 endpoints.

 

Developer application process

How do I apply for a developer account?

Developers can apply for a Twitter developer account filling out an application for API access with specific use case details.

To ensure quick Approval, please be as detailed as possible with your use case. Also, please pay close attention to the email address that is associated with the @user account that you used to apply. If our team needs additional details about your use case, we will reach out to this email address with questions. 

What happens after I apply?

Twitter reviews applications to ensure compliance with the Developer Agreement and Policy, Automation Rules, Display Requirements, and Twitter Rules. Developer Applicants will receive an email when the review is complete, or if more detail is needed about the described use case.

How will I be notified about my application?

You will be notified with updates about your application via the email address you verified before submitting your application.  We will continue to use this email for all correspondence about your application, even if you later change the email associated with your Twitter account in your Twitter App settings.   

What email is being used to send communications about my developer account?

The email address associated with your Twitter account and that you verify to submit your application is the email that will be used for communications about the application status.  At this time, the email for application-related correspondence cannot be changed after the application is submitted.

When will I get access?

We aim to review all applications quickly. While in review, you will see “application under review” when you go to our developer portal. If it’s unclear how you intend to use the Twitter API, it may delay our review and prompt requests for more detail, which can delay access. Please make sure the information you provide is accurate and detailed, and monitor your email for updates or requests for more information.

How can I check the status of my application?

You will be notified with updates about your application via the email address you verified before submitting your application.  There is no way to check the status of an application through the developer portal at this time, so please monitor your email for updates or requests for more information; those emails will continue to come from developer-accounts@twitter.com.  

If your account has been pending for a while, please search your email inbox for messages from developer-accounts@twitter.com and respond with the information that it is requesting from you. If you are unable to find an email from developer-accounts@twitter.com, please use this form, making sure to select the "I have a question not covered by these points" option.

I think my application was closed before I responded to a request for more information. What can I do?

Developers can reopen a dormant (non-rejected) application review by responding to the last email sent to your email address about your application and provide the details requested to continue the application process.

I'm receiving a "server error" when trying to apply for an organization account. How do I get past this?

If you receive an error that mentions that your organization handle does not exist, you will have to navigate back to the "Organization" page in the application flow and select a valid Twitter handle. Once you do this, you will be able to submit your application. 

What if I get rejected?

Applications may be rejected if they are found to be in violation of any section of the Developer Agreement and Policy, Automation Rules, Display Requirements, and/or the Twitter Rules.

We don’t currently allow you to appeal this decision. We are investigating options to allow people who feel they’ve been inappropriately rejected to appeal. Please stay informed of future updates.

Please do not write into the forums asking about your rejection, as we cannot comment on rejections publicly. 

Can I re-apply for a developer account?

No, not at this time. If this changes we will announce through our multiple channels here: Stay Informed.

Is it possible to have multiple developer accounts?

At this time, a single Twitter user can have a single developer account or can be a member of an organization account. Users that already have a developer account cannot apply for another, nor can they be added to other's developer accounts.

 

Developer portal management

What is the developer portal?

The developer portal is a self-serve user interface within developer.twitter.com where developers can manage their API access and Twitter Projects and Apps. The developer portal is visible with a logged-in context to developer.twitter.com and an Approved developer account.  You can access the developer portal by clicking where it says "Developer Portal" in the top right-hand corner of developer.twitter.com.

How do I access my developer account?

A developer account is owned by a specific Twitter @user and is viewed through a logged-in context at developer.twitter.com. If a Twitter user is logged into Twitter and visits developer.twitter.com, the logged-in user will be shown in the top left corner, and actions are taken within the screen's context affect the logged-in user's developer account.

I’m a Verizon customer and I can’t log in to my account

If you’re a new or existing Verizon customer, you may not be able to log in to your account because you’re not receiving a login verification PIN via text message. Try logging out of your Twitter account and logging back in. You should then receive a verification PIN via SMS. If this doesn't resolve your issue, send a text message from your device with the message content, GO, to the Twitter shortcode 40404. This will opt you in to receive SMS from Twitter, which is consistent with your notification settings. More details can be found on this help page.

What are some best practices for managing a company's Twitter development tools?

If you are going to be developing with Twitter for your company, then we recommend that you apply for an 'organization' account using your company's Twitter handle. If your company's engineering team uses Twitter Apps for work related to the company that isn’t owned by this company's Twitter handle, we suggest for you to transfer those Twitter Projects and Apps over to the company's account. You can do so by applying to transfer App ownership. Having all Twitter Projects and Apps owned by the company's Twitter handle will help to prevent any issues in the future in case an engineering resource leaves the company.

Why can't I see the "Team" option on my account drop-down?

This means that you've applied as an individual account, as opposed to an organization account.  The difference is the ability to give additional users access to a shared dev environment.

Can I change my individual account to an organization account?

Changing an individual setup to a team setup is not possible today.

Can a developer be on two different developer accounts?

This is not possible at this time. If you do need multiple accounts, please let us know in our developer forum.  

How many developers can I have on my account?

There currently isn't a limit on the number of developers on your team. To review team members, roles, and added dates, see the "Team" page.

Why can't I add a specific team member to my account?

When building out your developer/admin team on the "Team" page, there are some things to consider:

Team members @handle can only be added to a developer account if:

  • The @handle is not suspended, protected, muted or blocked by the @handle account admin.
  • The @handle must have a verified email address and allow email.
  • The @handle is not a member of any other developer account.
  • The @handle has not applied or been approved for its own developer account.
  • If the @handle was invited to join the dev account, but then the invite was revoked, the @handle cannot be re-invited for 24 hours.


If your team member never received an email, please ask them to double-check to see if they have an email address associated with their Twitter account, located in Twitter settings

This depends on the product that you are using and the tier at which you are subscribed. In the products section of the developer portal, you can explore our different product offerings.

Where can I learn more about Twitter Projects, Apps and the dashboard?

We have a documentation section specifically for ProjectsTwitter Apps and the dashboard. You can review the related FAQs on Apps and Projects.

Do you still have a question about the dev portal that isn't addressed here?

Please search our developer forum's developer portal section.

 

Premium API billing FAQs

How do I add a credit card or debit card?

If your developer application has been approved, you will be able to add a credit card for premium upgrades.   To add a new credit card to your developer account, log into the developer portal > side panel > account > billing > payment methods > add a new payment method.  In order to finish setting up your card from the add new payment method page, follow these instructions:

  1. Enter all the relevant fields for your card. 
  2. Make sure your address matches the billing information on your card
  3. Click submit

What types of credit/debit cards do you accept?

Twitter currently accepts Visa, MasterCard, American Express, Diners Club, and JCB credit cards as a payment source. 

How often will I be charged?

Billing for Premium Twitter data APIs occurs monthly based on the date of the first premium product subscription purchased.  The renewal date of your premium subscriptions is listed on the subscriptions page as the 'Subscription renewal date' and charges are made at the specified date and the UTC time 00:00:00. If you subscribe to a paid tier or upgrade paid tiers in the middle of your subscription month, the invoice will be prorated based on the amount of time left in the month.  Then on your subscription renewal date, you will be charged the full price for the next month.

Can I pay with ACH or pay for multiple months in advance?

The only payment option currently is a monthly subscription paid by card. Advance payment or other payment options are not available with the premium tier. If you would like to discuss a custom subscription with our enterprise sales team, please contact them through this form

What does the invoice/charge look like?

Charges to the card on file for premium will have the description "Twitter Dev Platform" and the emailed invoice will use the billing name and address on the credit card.  We will only generate invoices with the billing name and address of the credit card on file. We don't currently have any way of generating an invoice with a different address.  Notifications of changes are sent to the developer account owner's email and recent invoices can be reviewed in the developer portal transactions page.

Where can I see confirmation of my upgrade/downgrade or charges?

Invoices for subscription charges, upgrades, and downgrades will be emailed to the developer account owner's email promptly after changing the subscription.  Developer account-related emails will come from the no-reply email address: developer-accounts@twitter.com.

If I've already used some sandbox requests for the Search Tweets endpoints, will those requests count towards my paid premium subscription?

Each tier increases the maximum number of requests for the subscription period. When you upgrade to a higher paid tier of premium, your total number of requests for that billing period will be the number associated with the paid tier. In other words, your paid requests are not additive to any sandbox requests that you might have made throughout the month.

For example, if you have used 240 requests with the sandbox tier of Search Tweets: 30-day and decide to upgrade to the 500 total requests paid tier, you will have an additional 260 requests during the subscription period for a total of 500 requests. 

How is the monthly Tweet capacity calculated?

Monthly Tweet capacity is based on each product and subscription level.  Only one dev environment is allowed per premium product at this time. For Search 30-day, the monthly cap for Tweets queried is 25 thousand for the free Sandbox and up to 5 million in paid tiers.  If Search Tweets: Full Archive is also active, that product would have a UTC monthly cap for Tweets queried of 5 thousand for the free Sandbox, and up to 2.5 million in paid tiers. Each product's capacity is mutually exclusive. The paid tiers are only tiered based on the number of requests available.

When should I cancel/downgrade if I need to?

Subscriptions must be changed before the next renewal date to not get charged for the next month.  It is not possible to give refunds at this time.

I have already paid for a paid premium tier this month. If I upgrade to a higher tier, how will that affect my bill?

When you upgrade from a paid tier to a higher paid tier of premium, the additional paid fee will be prorated for the first month. You will then be charged the higher tier's fee for any subsequent months. 

Why do I have a credit on my invoice?

When you upgrade to a higher tier, a prorated credit for your existing tier is Applied to your invoice.

How do I downgrade from a paid tier to a lesser tier or to the "Sandbox" package?

If you are downgrading to a lower-paid tier, you can do so by navigating to the product in question's subscription management page by clicking the "Upgrade" button on the "Subscriptions" page. From here, select the desired tier in the "Choose the level of usage" table and click the "Review changes" button. 

If you are canceling your paid subscription and moving back to the free "Sandbox" package, you can do so from the "Subscriptions" page by clicking the ellipsis next to the product in question and selecting "Cancel."

Please note that subscription periods are in UTC time.

When should I cancel/downgrade if I need to?

Subscriptions must be changed before the next subscription renewal date and time to not get charged for the next month.  The subscription renewal date can be found in the developer portal on the subscription page here. Note that renewals are also time-specific and are charged based on UTC time 00:00:00.  It is not possible to give refunds at this time.

How do I downgrade my subscription?

If you are downgrading to a lower-paid tier, you can do so by navigating to the specific product's subscription management page by clicking the "Upgrade" button on the subscription page.

Choose a different tier and follow the prompts to accept the new tier level.

How do I cancel my subscription?

If you are canceling your paid subscription and moving back to the free "Sandbox" package, you can do so from the "Subscriptions" page by clicking the ellipsis (...) next to the product in question and selecting "Cancel."  Review the prompts and verify cancellation by seeing your "New subscription details" with the product package 'Sandbox' and Price per month $0.

If I've already used some sandbox requests, will those requests count towards my paid premium subscription?

When you upgrade to a paid tier of premium, your total number of requests for that billing period will be the number associated with the paid tier. In other words, your paid requests are not additive to any sandbox requests that you might have made throughout the month.

For example, if you have used 240 requests with the sandbox tier of Search Tweets: 30-day and decide to upgrade to the 500 total requests paid tier, you will have an additional 260 requests during the subscription period for a total of 500 requests. 

I have already paid for a paid premium tier this month. If I upgrade to a higher tier, how will that affect my bill?

When you upgrade from a paid tier to a higher paid tier of premium, the additional paid fee will be prorated for the first month. You will then be charged the higher tier's fee for any subsequent months. 

What if my card is declined on an auto payment?

Twitter auto-renews your credit card at the end of your billing cycle, and if it declines or there is some issue with your card, the system by default will not retry. We will notify you via email that there was an issue running your card, and give you a few days to renew again.  If you're finding there are frequent issues with running your credit card, you should talk to your bank to let them know to expect this recurring charge as they may be able to put a note on your account to avoid disruption.

If a premium subscription is not properly renewed or the payment fails by the date on your subscriptions page, the system assumes that you didn't want to renew.  An email is sent to the account owner and access is allowed for 2 extra days, where after all premium subscriptions are downgraded to the sandbox tier of the product, and any subscriptions above the 15 (sandbox level of access) are dropped.

Will I be notified before my card is charged for my monthly premium subscription?

Yes, notification emails are sent to the developer account owner to notify them that the subscription is coming up for renewal.  There are also additional email notifications for card expiration and failed payment.

Where can I read more about the billing terms and conditions?

Please refer to our terms and conditions page here.

What if I have a premium API billing question not addressed here?

Once you've logged into the developer portal, you can access our billing support channel via the billing page.

 

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.