API

This article covers the creation of an API key and configuration of Postman to make API calls. Please note this is for demonstration purposes only. This article assumes you have used Postman previously. This article is not intended to be all-encompassing documentation on using our REST API. For detailed information regarding our REST API endpoints, please see our Teams API page.

Generate API key

1. Login to the Teams admin portal.
   • You must be logged in as a Super Admin to generate an API key.
2. Click 'Keys' on left panel.
3. Click 'Generate API Key.'
   
4. Provide a friendly name for the API key. Click 'Continue.'
   
5. Click the 'Copy' icon to copy the API key.
   
   • As displayed in the warning, do not lose this key and keep it secured. This key provides authorization to make API calls against your Parsec for Teams tenant. If this keys falls into the wrong hands, they will have full access to your Parsec for Teams tenant. 

Configure Postman

Postman is an API platform for building and using APIs. The following steps cover how to create a collection for Parsec API calls and a few sample requests.

Create a collection

1. Click '+ New.'
2. Click 'Collection.'
   
3. Provide a friendly name for the collection.
4. Click 'Authorization' tab.
5. Select 'Bearer Token' under 'TYPE.'
6. Paste your API key in the 'Token' field.
7. Click 'Create.'
   

Configure request

1. Click the ellipsis '...' on your new collection.
2. Click 'Add Request.'
   
3. Provide a friendly name for your new request.
4. Click 'Save to <your collection name>.'
   
5. Confirm that the request method is set correctly. In this case, because we are getting Groups, our HTTP method will be 'GET.'
6. Configure the request URI.
   1. Example) https://api.parsec.app/v1/teams/YourParsecTeamID/groups?offset=0&limit=200
7. Ensure required path and/or query params are provided. In this case, because we are getting Groups, both 'offset' and 'limit' are required query params.
   

Send a request

1. Click the 'Authorization' tab and ensure 'TYPE' set to 'inherit from parent.'
2. Click 'Send.'
   
3. Observe API response.
   

What's next?

It is possible to automate certain tasks by leveraging our API. As an example, we can send an invites to new Team members and pre-assign them to a group programatically. This takes a huge burden off of administrators, requiring them to do fewer tasks manually.

The screenshot below shows an example request to create a new Team invite, where the new Team member is automatically assigned to the 'NY-Artists' group from the previous example.