Skip to main content

Destination

Nexla's bi-directional connectors allow data to flow both to and from any location, making it simple to create a FlexFlow, DB-CDC, Spark ETL, or Replication data flow that sends data to a Maropost location.
maropost_api.png

Maropost

Create a Maropost Destination​

  1. Click the + icon on the Nexset that will be sent to the Maropost destination, and select the Send to Destination option from the menu.

  2. Select the Maropost connector from the list of available destination connectors. Then, select the credential that will be used to connect to your Maropost account, and click Next; or, create a new Maropost credential for use in this flow.

  3. In Nexla, Maropost destinations can be created using pre-built endpoint templates, which expedite destination setup for common Maropost endpoints. Each template is designed specifically for the corresponding Maropost endpoint, making destination configuration easy and efficient.
    • To configure this destination using a template, follow the instructions in Configure Using a Template.

    Maropost destinations can also be configured manually, allowing you to send data to Maropost endpoints not included in the pre-built templates or apply further customizations to exactly suit your needs.
    • To configure this destination manually, follow the instructions in Configure Manually.

Configure Using a Template​

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Maropost endpoints. Each template is designed specifically for the corresponding Maropost endpoint, making destination setup easy and efficient.

  • To configure this destination using a template, select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

    Create List

    This endpoint template creates a new list in your Maropost account. Use this template when you need to create new lists in Maropost from your data flow, such as contact lists, segment lists, or custom lists.

    • This endpoint automatically creates a new list in your Maropost account using the data from your flow. No additional configuration is required beyond selecting this endpoint template. The data structure must match the Maropost API's expected format for creating lists.

    This endpoint sends data as JSON in the request body to create a new list in Maropost. The data structure must match the Maropost API's expected format for creating lists. Ensure your data flow provides the required fields for list creation, such as list name and other list properties.

    For detailed information about available endpoints, required fields, data formats, and API usage limits, see the Maropost API documentation.

    Create Contact

    This endpoint template creates a new contact in your Maropost account. Use this template when you need to create new contacts in Maropost from your data flow, such as adding new subscribers to your email lists or creating contact records from external data sources.

    • This endpoint automatically creates a new contact in your Maropost account using the data from your flow. No additional configuration is required beyond selecting this endpoint template. The data structure must match the Maropost API's expected format for creating contacts.

    This endpoint sends data as JSON in the request body to create a new contact in Maropost. The data structure must match the Maropost API's expected format for creating contacts. Ensure your data flow provides the required fields for contact creation, such as email address and other contact properties.

    For detailed information about available endpoints, required fields, data formats, and API usage limits, see the Maropost API documentation.

Configure Manually​

Maropost destinations can be manually configured to send data to any valid Maropost API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

With manual configuration, you can also create more complex Maropost destinations, such as destinations that send data to multiple endpoints or destinations that require custom request headers or parameters.

API Method​

  1. To manually configure this destination, select the Advanced tab at the top of the configuration screen.

  2. Select the API method that will be used for calls to the Maropost API from the Method pulldown menu. Maropost API typically uses POST method for creating new resources.

API Endpoint URL​

  1. Enter the URL of the Maropost API endpoint to which data will be sent in the Set API URL field. This should be the complete URL including the protocol (https://), the API base URL (api.maropost.com), your Account ID (from your credential), and the API path (e.g., https://api.maropost.com/accounts/{account_id}/contacts.json).

Ensure the API endpoint URL is correct and accessible with your current credentials. The Maropost API endpoint URL should point to the specific resource type you want to create or update. You can test the endpoint using the Test button after configuring the URL.

Request Body​

  1. Configure the request body that will be sent to the Maropost API. The request body should contain the data to be created or updated in Maropost, formatted as JSON. The request body format is typically {message.json} which sends the entire Nexset data as JSON.

The request body must be valid JSON and must match the Maropost API's expected format for the specified resource type. Ensure your data flow provides the required fields for the resource type you're creating. The data structure must match the Maropost API's expected format. For detailed information about required fields and data formats, see the Maropost API documentation.

Save the Destination​

  1. Once all of the relevant steps in the above sections have been completed, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the destination configuration for later use.