Skip to main content
POST
Test a feed's mapping on a sample

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Body

application/json
csv
string | null

The sample as CSV text: the header row and at least the rows to check

Required string length: 1 - 1048576
feed
FeedSettings · object | null

Or a feed not saved yet, in the column shape

import_id
string | null

Or a file Statisfy received (integrations.list_imports): its exact bytes

Required string length: 1 - 64
name
string | null

A saved feed to test

Required string length: 1 - 255

Response

200 - application/json

Successful Response

The app's test verdict on the same file (the wizard's Test step).

account_matches
MappingTestAccount · object[]
required
custom_field_updates
MappingTestFieldUpdate · object[]
required
custom_object_records
MappingTestObject · object[]
required
errors
MappingTestError · object[]
required

Rows a real run fails (and skips, in strict mode)

more_rows_in_file
boolean
required

The file has rows after the checked ones

product_usage_records
MappingTestUsage · object[]
required
rows_validated
integer
required
success
boolean
required

The rows checked would import; warnings may still apply

summary_stats
MappingTestSummary · object
required
warnings
string[]
required

Bad cells, fields the feed won't write, and other notes