TinyEmail

TinyEmail is an email marketing platform for building audiences, sending campaigns, managing sender identities, and tracking subscriber engagement. The TinyEmail connector lets Nexla ingest audiences, contacts, campaigns, sender details, suppression lists, and engagement reports as a data source, and send records back to TinyEmail to create, update, and manage audiences and subscriptions.

Power end-to-end data operations for your TinyEmail API with Nexla. Our bi-directional TinyEmail connector is purpose-built for TinyEmail, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to TinyEmail or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your TinyEmail workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a TinyEmail credential, you need a TinyEmail API key. API access is available on TinyEmail Enterprise plans. Requests are authenticated with an API key passed as a Bearer token in the Authorization header.

To obtain your TinyEmail API key, follow these steps:

1. Confirm that your TinyEmail account is on a plan that includes API access. If it is not, upgrade your plan or contact TinyEmail to enable API access.

2. Sign in to your TinyEmail account and open your account settings to check whether an API key is available for your account.

3. If an API key is not shown in your account settings, request one from TinyEmail support by email at support@tinyemail.com or through the in-app support chat.

4. Copy the API key and store it securely, as it grants access to your TinyEmail data and should be treated as a secret.

For detailed information about the TinyEmail API and its available endpoints, see the TinyEmail API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Key	Yes	Yes	Your TinyEmail API key, found in account settings.

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

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

3. Enter your TinyEmail API key in the API Key field. This is the key you obtained in Prerequisites. Nexla sends it as a Bearer token in the Authorization header for all API requests, so it must be kept confidential.

   If your API key is compromised, contact TinyEmail support to rotate it, then update the credential in Nexla with the new key.

   For detailed information about the TinyEmail API and its available endpoints, see the TinyEmail API documentation.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the TinyEmail connector tile, then select the credential that will be used to connect to TinyEmail, and click Next; or, create a new TinyEmail credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common TinyEmail endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Audiences

This endpoint template retrieves all audiences (contact lists) with their member counts. Use it to sync the full set of audiences in your TinyEmail account for reporting or downstream processing.

For more information about audiences, see the TinyEmail API documentation.

[Rest API] List Contacts

This endpoint template retrieves contacts from your TinyEmail account. Use it to access contact records for analysis, reporting, or synchronization with other systems.

For more information about contacts, see the TinyEmail API documentation.

[Rest API] List Contact Members

This endpoint template retrieves contact members from your TinyEmail account. The endpoint is paginated, and Nexla automatically follows the pages to fetch the complete set of records.

For more information about contact members, see the TinyEmail API documentation.

[Rest API] List Campaigns

This endpoint template retrieves campaigns from your TinyEmail account. The endpoint is paginated, and Nexla automatically follows the pages to fetch the complete set of campaign records for reporting and analysis.

For more information about campaigns, see the TinyEmail API documentation.

[Rest API] List Sender Details

This endpoint template retrieves the sender details configured in your TinyEmail account, such as the sender identities used when sending campaigns.

For more information about sender details, see the TinyEmail API documentation.

[Rest API] List Suppressions

This endpoint template retrieves all suppression lists, including email, MD5, and SHA256 entries, along with their scope and processing status. Use it to sync suppressed recipients for compliance and deliverability reporting.

For more information about suppressions, see the TinyEmail API documentation.

[Rest API] Get New Subscriber Engagement Stats

This endpoint template retrieves daily engagement metrics for newly added subscribers, including sends, delivered, opens, clicks, and unsubscribes, across the audiences you specify within a date range.

• Set the From and To parameters to define the reporting window, in UTC format. The window must not span more than 7 days.
• Set the Audience Ids parameter to the audience (contact list) UUIDs you want to report on. A maximum of 10 audience IDs is allowed per request.

For more information about engagement reports, see the TinyEmail API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

TinyEmail data sources can also be manually configured to ingest data from any valid TinyEmail API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new TinyEmail data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the TinyEmail destination, and select the Send to Destination option from the menu. Select the TinyEmail connector from the list of available destination connectors, then select the credential that will be used to connect to TinyEmail, and click Next; or, create a new TinyEmail credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common TinyEmail endpoints. 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.

[Rest API] Create Audience

This endpoint template creates a new audience (contact list) with members in TinyEmail using records from a Nexset. Each record is sent as JSON in the request body to create a new audience.

The audience structure must match the format expected by the TinyEmail API. For more information, see the TinyEmail API documentation.

[Rest API] Update Audience

This endpoint template updates an existing audience (contact list) by ID in TinyEmail using records from a Nexset. Each record is sent as JSON in the request body to update the target audience.

Include the audience ID for the audience to be updated. For more information, see the TinyEmail API documentation.

[Rest API] Delete Audience

This endpoint template deletes an existing audience (contact list) by ID in TinyEmail using records from a Nexset. Each record identifies an audience to be removed.

Deleting an audience is irreversible. Confirm the audience ID before activating this destination. For more information, see the TinyEmail API documentation.

[Rest API] Import Audience Contacts

This endpoint template creates a new contact list by importing members from a CSV file into TinyEmail. Use it to bulk-load contacts into a new audience from your Nexla flows.

For more information about importing audience contacts, see the TinyEmail API documentation.

[Rest API] Unsubscribe Customer

This endpoint template unsubscribes a customer from all audience lists in TinyEmail using records from a Nexset. Use it to keep suppression and opt-out status in sync with your source systems.

For more information about unsubscribing customers, see the TinyEmail API documentation.

Manual configuration

TinyEmail destinations can also be manually configured to send data to any valid TinyEmail API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

TinyEmail APIs typically expect JSON format for most operations. For update or delete operations, include the ID of the target object in the request URL.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured TinyEmail endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the TinyEmail endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.