How can I use Zapier with ProsperWorks webhooks?

ProsperWorks webhooks allows you to subscribe to changes that happen in ProsperWorks. To use this article you will need a Trial, Professional or Business account. Full documentation of webhooks is here.

 

1. Create a Zapier account:

https://prosperworks.zendesk.com/hc/en-us/articles/115000333246-How-do-I-connect-my-account-to-Zapier-

 

2. Open Zapier and create a new Zap

 

3. Type in Webhook and select it

 

4. Select Catch Hook

 

5. Do not enter anything here, just select Continue

 

6. Underneath where it says "Use this:", is your unique URL that ProsperWorks will send alerts to. Copy/paste this somewhere for safe keeping. We will use it later.

 

7. Now we are going to create a subscription to a webhook, basically, to be alerted from ProsperWorks when something changes, etc.

 

There are different things you can subscribe to. For simplicity, in this example we are going to subscribe to receive a notification when a new person is created in ProsperWorks. For more information on what kind of updates you can receive notifications on, view our webhook documentation.

 

The following steps will require you to know or learn how to make a CURL  request in terminal, PostMan or another tool.

 

Steps: 

a. Open a text editor and copy/paste the block of text from step 8 there. Paste the URL from step 6 inside the quotes where it says PASTE URL HEREChange the text CHANGEME to something else.

b. Please open up CURL (here is how to open terminal to use CURL) or use PostMan with CURL if you do not have terminal.

 

8. Please copy/paste this CURL request into terminal after replacing the items in bold:

curl --request POST \
--header "Content-Type: application/json" \
--header "X-PW-AccessToken:YOURAPIKEYFROMSETTINGS->APIKEYS" \
--header "X-PW-Application: developer_api" \
--header "X-PW-UserEmail:YOUREMAIL" \
https://api.prosperworks.com/developer_api/v1/webhooks \
--data '{"target":"PASTE URL HERE","type": "person","event": "new","secret":{"key":"CHANGEME"}}'

 

If you are importing into Postman because you cannot use terminal, remove all backslashes before clicking "import"

 

This is what it will look like in terminal:

 

 

 

9. After you have made a subscription. Click "Okay I did this" from before. Then go to ProsperWorks and create a new person record.

 

10. It should pick up the ID of the person you created

 

11. Click "view your hook" to see the ID of the record and find the record in ProsperWorks (you can do this by viewing the URL)

 

12. Yes, this is the right record, because the ID from above matches in the URL:

 

13. Then make a custom request to get the data from the ID

 

 

14. Then scroll down and make four headers and fill in your email and API key

 

 

15. Now you can add an action to update other systems with your updated ProsperWorks records! Or, you can delete your webhook request or, make a different subscription by following the instructions here.

 

In this example, I am filtering by assignee_id, formatting the text to split by commas, and pushing the values from step 2 into a Google Sheet.

 

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Article is closed for comments.