Skip to main content

Authorization

Follow this guide to create a new Maropost credential that will allow Nexla to authenticate to and exchange data with your Maropost account.
maropost_api_auth.png

Maropost

Prerequisites​

Before creating a Maropost credential, you need to obtain your API key and Account ID from your Maropost account. Maropost uses API key authentication for all API requests, with the API key sent in the auth_token header.

To obtain your Maropost API credentials, follow these steps:

  1. Sign in to your Maropost account using your administrator credentials.

  2. Navigate to the Connections or Settings section in your Maropost dashboard.

  3. Look for the API or API Keys section in the settings menu.

  4. If you don't have an API key yet, click Generate API Key or Create API Key to create a new API key.

  5. Copy the API key immediately after it's generated, as it may not be accessible again after you navigate away from the page.

  6. Locate your Account ID in your Maropost account settings or dashboard. The Account ID is typically displayed in your account information or can be found in the URL when you're logged into your Maropost account.

  7. Store both the API key and Account ID securely, as you will need them to configure your Nexla credential. The API key is sensitive information and should be kept confidential.

The API key is sent in the auth_token header for all API requests to the Maropost API. The Account ID is used to construct API endpoint URLs specific to your Maropost account. The API key authenticates your requests and grants access to Maropost resources based on your account permissions. If your API key is compromised, you should immediately revoke it in your Maropost account settings and generate a new one. Maropost enforces rate limits with a maximum of 10 concurrent API calls per account. For detailed information about API authentication, available endpoints, and API usage limits, refer to the Maropost API documentation.

Create a Maropost Credential​

  • To create a new Maropost credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Maropost

MaropostCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

Maropost uses API key authentication for all API requests. The API key is sent in the auth_token header to authenticate API requests to the Maropost API.

  1. Enter your Maropost API key in the API Key Value field. This is the API key you obtained from your Maropost account settings (Connections or Settings > API Keys). The API key is sent in the auth_token header for all API requests to the Maropost API. The API key is sensitive information and must be kept confidential.

  2. Enter your Maropost Account ID in the Account Id field. This is the Account ID you obtained from your Maropost account. The Account ID is used to construct API endpoint URLs specific to your Maropost account (e.g., https://api.maropost.com/accounts/{account_id}/lists.json). The Account ID is typically displayed in your account information or can be found in the URL when you're logged into your Maropost account.

    Your Maropost API key can be found in your Maropost account settings under the Connections or Settings > API Keys section. Your Account ID can be found in your account information or in the URL when you're logged into your Maropost account. The API key is sent in the auth_token header for all API requests to the Maropost API. The Account ID is used to construct API endpoint URLs specific to your Maropost account.

    If your API key is compromised, you should immediately revoke it in your Maropost account settings and generate a new one. The API key provides access to your Maropost data and should be treated as sensitive information. Maropost enforces rate limits with a maximum of 10 concurrent API calls per account. Exceeding this limit results in an HTTP Status Code 429 response.

    For detailed information about API authentication, available endpoints, and API usage limits, see the Maropost API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.