Create mapping

POST/v1/import-mappings

Save a mapping.

Scope imports:writeIdempotency-Key optional

Request body

namestringRequired
1 to 80 characters
formatenumRequired
One of csv, json
mappingobjectRequired

Response

  • 201Success
Response fields
idstringRequired
namestringRequired
formatstringRequired
mappingobjectRequired
created_atstringRequired
updated_atstringRequired

Errors

  • 401unauthorized. The key is missing, unknown or revoked
  • 403insufficient_scope. The key lacks the scope above
  • 403forbidden, or insufficient_scope
  • 409mapping_exists, or idempotency_conflict
  • 422validation_error, or mapping_invalid

Every error has the same shape. See Errors.