Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → Developers → API Keys.

Headers

Idempotency-Key
string

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Maximum string length: 100

Body

application/json
projectId
string
required

Brand (project) ID

Pattern: ^[0-9a-fA-F]{24}$
provider
enum<string>
required
Available options:
klaviyo,
mailchimp,
hubspot
sources
object[]
required
Required array length: 1 - 25 elements

Whether to import only contacts with clear marketing consent

Available options:
subscribed-only,
include-all
connectionId
string

Connected integration account ID when multiple accounts are linked

Response

Import accepted for background processing

success
boolean
required
data
object
error
string | null
Last modified on October 3, 2026