Skip to main content
POST
Create import
Requires a scoped personal key, explicit project selection, and current role authorization. See Agent imports for validation, consent, preparation, and recovery.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>
required

Body

application/json
kind
enum<string>
required
Available options:
contacts,
properties,
audiences,
memberships,
topic_subscriptions
format
enum<string>
required
Available options:
csv,
xlsx,
json,
ndjson,
batches
idempotency_key
string
required
Required string length: 8 - 160
file_name
string
Required string length: 1 - 255
worksheet
string

Required for Excel; exact worksheet name.

Required string length: 1 - 100
mapping
object[]
Maximum array length: 100
audience_id
string<uuid>
topic_id
string<uuid>
Available options:
none,
asserted
automation_effects
enum<string>
default:suppress
Available options:
suppress,
trigger
strict
boolean
default:false
delimiter
enum<string>
default:,
Available options:
,,
;,

Response

200 - application/json

Successful operation

status
integer
required
data
object
required