Getting Started

Step 1

Request API Access

The first step in buiding an integration with the Atlas API is to request a Client ID and Client Secret to be used when making calls to the Atlas authorization servers.

For data privacy reasons, requests for API access must come from a Atlas customer. To get your Client ID and Client Secret, you will need to ask the Atlas customer that you're working with to send a request to apisupport@memberclicks.com. In the request, the customer will need to provide the following information:

• Customer Name: the Atlas customer's association/chamber name
• Requester Name: the name of the staff member making the request
• 3rd Party Name: your company's name (used in your ClientID)
• 3rd Party Email: your email address for us to include when replying with your credentials

Upon receiving the request, Atlas will validate the information provided and then reply to both you and the requesting staff member with your API credentials. The following information will be provided in the reply:

• Client ID: your Client ID value to be submitted when making authorization requests
• Client Secret: your Client Secret to be submitted when making authorization requests
• Tenant: the Tenant value(s) you have been granted access to
• API Base URI: the base API URI you will use when making requests

Step 2

Get an Access Token

Once you have received your API credentials, you're ready to make your first requests to the Atlas authorization and resource servers. A simple way to get started with making API requests is to use Postman to quickly and easily make your first API requests. Once you have your API request mechanism set up, we're ready to make an authorization request.

For this initial example, we'll make a simple authorization request using the Client Credentials grant type. For more information on the different API authorization workflows, visit the API Authorization page. Here's the basic structure of a Client Credentials authorization request (replace the bracketed values with the information in your credentials):

The resulting response will look like the following example:

Step 3

Make a Resource Request

Now that we have an access token, we're ready to make our first resource request. We'll start with a simple example that will return a search for Profiles flagged as a member. For this request, we'll also need the Atlas customer's base API URI to make our request.

The request header should provide the access token to the resource server, and the request URI will contain our search parameters. The following example uses the token from our above example and has the correct search criteria set for looking up member profiles:

The resulting response will contain a collection of ProfileMinDtos that meet your search results. Here's an example response for our member search request:

Congratulations, you've now made your first requests to the Atlas API. For more information on your authorization options visit our API Authorization page and for a list of available resource routes, check out our API Resources page.