Bulk-import suppressions

Requires EDITOR and TRACKLY_PII_HMAC_KEY. Provide emails array and/or text blob (one per line).

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Tenant project id (row-level isolation on every query).

Request Body^required

Media typeapplication/json

object

reason

string

default: imported

Allowed values: bounce complaint unsubscribe manual imported inbound_unsubscribe

scope

string

default: project

Allowed values: project global

emails

Array<string>

<= 10000 items

text

string

<= 1000000 characters

Responses

200

Import counts.

Media typeapplication/json

object

inserted

integer

skipped

integer

total

integer

400

Validation error, or no importable emails found.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

401

Not authenticated (no valid session/principal).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Authenticated but lacks the required project role.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

500

PII HMAC key not configured.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}