Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.maestra.io/llms.txt

Use this file to discover all available pages before exploring further.

This import appends contacts to your project’s blocklist. Imports run from Settings → Import. Click New import to open the wizard.

​
Step 1. Choose an action

  • Pick the import type — Blocklist.
  • Pick the action — Import to blocklist.

​
Step 2. Prepare and upload the file

  1. Decide which fields to include.
    FieldDescription
    ContactType (required)Type of contact to add. See allowed values below.
    Contact (required)The contact value itself.
    CustomFieldSystemNameSystem name of the identifier. Required when ContactType is ExternalIdentity.
    Allowed ContactType values:
    • Email — email address
    • MobilePhone — mobile number
    • ExternalIdentity — customer identifier; provide its system name in CustomFieldSystemName
    • Device — device identifier
    • DiscountCardNumber — loyalty card number
  2. Prepare the file. Put column headers (field names) in the first row.
    • Format: .csv or .txt
    • Recommended encoding: UTF-8
    • Make sure values match the expected formats
    See Preparing a file for import for details.
  3. Upload the file and click Continue.

​
Step 3. Review and start the import

Before launching, Maestra Platform shows the first rows of your file with the mapping applied. Confirm that values land in the correct fields. If everything looks right, click Start import.

​
Tracking the import

After it starts, the import appears in the list on the Import page. Each job shows:
  • Date started
  • Import type
  • Who started it
If errors occurred, some rows will have been skipped. Open the import details to see which rows failed and why.
Adding contacts to the blocklist does not stop campaigns from sending to them — they will still receive messages.To exclude these contacts from future campaigns, either clear the contact values on the matching customer profiles or delete those customers from the database. That way, the invalid contacts won’t appear on customer profiles and won’t be included in campaign recipient lists.