Twitter api key setup

• ! You need access to v1.1 api endpoints.
• ! This requires elevated access or the ability to create 'Standalone' apps
  • Note: creating a 'Standalone' app is not encouraged since it'll no longer work once harpy requests v2 api endpoints.

---

Step-by-step guide

1. Request access to the Twitter API.

2. Open the Twitter developer dashboard and create a new API Project.

3. Navigate to its overview page and click Add App. (Image 1)

4. Click Create new.

5. Select Production and click Next

6. Enter your app name and click Next. Any name will suffice.

7. Save your API Key and API Key Secret. You will need to enter the key and secret in harpy.

   • Note: The Bearer Token will not be needed for harpy.

8. Click on App settings and in the User authentication settings at the bottom click on Set up.

9. App permissions:

   8.1. Enable Read and write and Direct message. - Note: Enabling direct message is optional as harpy doesn't yet show DMs in the app.

10. Type of App:

    10.1 Keep Native App selected.

11. App info:

    11.1. Callback URI: enter harpy://

    11.2. Website URL: enter any url, e.g. http://example.com

    11.3. Other fields can be left empty.

    

12. Click Save and confirm the dialog with Yes

    • Note: The Client ID and Client Secret will not be needed for harpy.

You are now all set up!

You can now build harpy with your own api key and secret or enter the API Key and API Key Secret into the key and secret fields in the custom api setup page in harpy to use your own API access in the public harpy build.