This article outlines a series of steps to do the following:
How to setup and use Pronto API parameters, values and requests.
Pre-requisites:
1. Tenant admin only can create API-key.
2. Users can not view the data using API-key even though they have access using basic auth, only Administrators can.
3. API Environment (Post man is being used in this example).
Variables
In the API example articles, variables with {{API_HOST}} should be replaced with the full host URL hostname:
https://app.gopronto.io/api/v1/
Setup and Use Pronto API
1. Create API requests you wish to use in your API environment. In this case we are using Postman, and we will use a GET request for a contact within Pronto.
2. Next we need to set the Authorization type. Navigate to the Authorization tab and select API Key from the Type drop down menu.
3. Type X-API-KEY in the Key field. Note: Case does not matter but it is imperative you use the hyphens.
5. Navigate back into your Pronto environment. Select API Keys in the menu bar on left side, click Generate API Key in the top right hand corner.
6. Name the API Key and click Save.
7. After saving a new box will appear with the API Key. Select the Copy All icon and do not close until you are sure the key was copied to the clipboard.
8. Paste the API key in the Value and Header is selected in Add To.
9. Navigate to Params (Parameters).
10. Under Key type api_key_email.
11. The Value will be the email of the user you are logged into pronto as currently.
12. In Pronto, navigate to a relationship card that has contacts to get the contact ID from a contact you wish to test the API on.
13. Select a contact from Sales > Contacts.
14. Copy the contact ID from the URL as seen in the image below.
15. Go back into Postman and paste the contact ID here in postman.
16. Select the environment, in most cases app.gopronto.io or a test environment if you have a sandbox environment you are testing in.
17. The environment hostname goes here, again app.pronto.io or the hostname of the test environment.
18. You can run the API and open inspector at the same time to follow the api request. Open the window where you selected the Contact in Pronto. Click the three dot menu icon in your browser and select Dev Tools under More Tools, then select the Network tab. Once you have done so click Send in the Postman window. You should see the API successfully run in the Pronto window.
19. You can send it from postman as well and validate if it is working and we see it is s we are returned the data in this case the contact info from the GET API request.
Comments
0 comments
Article is closed for comments.