Skip to main content
POST
Preview an import before running it

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

source
string
required

Body

application/json
envelope
string
required

Encrypted credentials envelope returned by the connect / manual-credentials step.

entities
string[]
required

Entity kinds to preview (e.g. phone_numbers, contacts, messaging_services).

Required array length: 1 - 10 elements
conversationDays
integer

Optional lookback window for conversation history (Twilio caps this at 90 days).

Required range: 1 <= x <= 90

Response

Per-entity counts, estimated duration, and detected conflicts for the selected source.

data
object
meta
object