website logo
⌘K
Introduction
Basic Overview
Automation Editor
Manual
Environments
API Editor
Design
Webhooks
Connections
Constants
Monitor Your Tasks
Security
Invite Users
Access Management
Webhooks Setup
Google Calendar Webhook
Microsoft Mail Webhook
Quickbooks Webhook
Slack V2 Webhook
Stripe Webhook
Square Webhook
Twitter Webhook
Xero Webhook
Zoom Webhook
Core APIs
Core API Functions
Core Multi
Core Bulk
Text
Number
List
DateTime
JSON
Web
Account Management
Manage Account
Analytics
Request APIs
Request Provider
Docs powered by archbee 

Twitter Webhook

19min

Through Pathfix Automation, you can enable user webhook listening for all your user that have connected their Twitter account via Pathfix OAuth.

Twitter webhook will catch all events that are listed here and will only work for Twitter 1.0 (the webhook for Twitter does not support Twitter V2 yet for OAuth 2.0)

The following documentation will guide you on how you can setup your Twitter account and setup Twitter Webhook listening for all your connected users.



Setup in Pathfix OAuth

Before proceeding, make sure you have setup your Twitter integration in Pathfix OAuth and have added the Connect button for your users to be able to connect their Twitter accounts.

  • Configure your Twitter integration in Pathfix OAuth
  • Add the script tag to add the Connect button in your application to allow your users to authenticate their Twitter accounts (Detailed documentation for Pathfix OAuth can be found here)



Document image




Setup in Pathfix Automation

  • Create a blank automation by clicking on Design and selecting New Design
  • Give your first task a name to save the automation (autosave)



Document image




  • Click on the Test and Publish tab and click on Test to run a test on the automation
  • On successful completion, click on Publish to Live



Document image




  • Click on Endpoints and copy the endpoint url for use in the Webhook setup
  • Live Endpoint is for Live environments and Dev endpoint is for testing/development



Document image




  • Click on Webhooks from the top navigation and click on Create New
  • Select Twitter from the list of provider webhooks
  • Paste the endpoint URL copied from the automation into the Callback URL section
  • Add your Twitter Environment name (this is the environment name as per your Twitter developer app)
    • To view Environments go to: Products - Premium - Dev Environments (click here to check your Environments)
    • Make sure you pick the Account Activity API environment. If you do not have Account Activity API, create a new one.
  • Add the Twitter Client Secret (this is the Consumer Key's API Secret of your Twitter developer app, not the OAuth 2.0 Client Secret)

Document image




  • Click on the Pathfix OAuth tab and enter your Pathfix OAuth Public Key and Private Key
  • Add your Pathfix User Id (user your Pathfix OAuth login email here)
  • Click on Save to save the settings



Document image




  • On the Webhooks page, click on Activate against Twitter to activate your webhook



Document image




  • The webhook activation will take a few minutes and will happen in the background (click on Refresh on the top navigation to refresh the page)
  • Once activated, the webhook status will turn Green



Document image




Testing Your Webhook Setup

We recommend running a test on your webhook setup to make sure the setup is right. To do this:

  • Go to your Pathfix OAuth account and click on Test Connection for Twitter (make sure you have setup Twitter and not Twitter V2)
  • Click on Re-Connect and connect a Twitter account



Document image




  • On successful connection, the Automation will start listening for changes in Twitter for the connected user
  • You will see the webhook user count increase (if it doesn't increase at first, click on Refresh on the top navigation)



Document image




  • Go to your Twitter account and post a test tweet
  • Go to your Pathfix Automation account and click on Monitor
  • You should see the test event created would have triggered a webhook call



Document image


Your Test is successful.



Configure Your Automation

Now that your webhook has been setup successfully, you will need to copy the payload sent by Twitter and captured by Pathfix Automation and create your Automation.

Here are the few initial steps to get you going:

  • Copy the Request received from our test event



Document image




  • Go to the Automation created and paste the Request into the Call data (JSON) section of the first task



Document image




  • From here, you can call an API, run a condition or process the data as you please through the Automation



Document image




Important

  • Any changes made to the automation will need to be done in the Dev environment
  • Once changes are made, you will first have to Test the Automation and on successful completion then Publish to Live
  • Please note, without publishing to Live, the changes will not go into effect



Few points to note on the JSON:

  1. The pathfix_user_id is the same user Id that is sent via the Pathfix OAuth system. This generally is the Current Users Unique Id
  2. the data section of the JSON is the exact data that is sent by the provider







Need help? Reach out to our support via support@pathfix.com or live chat through your Pathfix dashboard

Updated 28 Feb 2023
Did this page help you?
Yes
No
PREVIOUS
Square Webhook
NEXT
Xero Webhook
Docs powered by archbee 
TABLE OF CONTENTS
Setup in Pathfix OAuth
Setup in Pathfix Automation
Testing Your Webhook Setup
Configure Your Automation