Acoustic Connect icon

Acoustic Connect

Interact with Acoustic Connect GraphQL API

Actions36

Data Job → Create Import Job

AI-generated

Summary

Create a data-set import job with specified options

Inputs

  • jobName (required) — Name for the import job
  • importType (required) — Import type options (CREATE, ADD_UPDATE, DELETE, REPLACE)
  • fileLocationType (required) — Where the import file is located
  • contentId (required) — The content ID of the uploaded file
  • folder (required) — The full path of the folder containing the file
  • filename (required) — The filename (without folder path)
  • fileFormat — The format of the import file
  • delimiter — The delimiter character (comma, tab, etc.)
  • skipFirstRow — Whether the first row contains headers that should not be imported
  • dataSetMode (required) — Whether to create a new data set or use an existing one
  • dataSetId (required) — The ID of the existing data set to import into
  • dataSetName (required) — The name for the new data set
  • dataSetType (required) — The type of data set to create
  • mappings — Map columns from the import file to data set attributes
  • additionalOptions — Additional job configuration options
  • notifications — Email notifications when job completes

Output shape

a job object representing the created import job

May include pagination; optional fields; on error an error envelope is returned

Examples

Example 1: Create a new audience data set from a CSV uploaded via web upload

jobName=importA, importType=CREATE, fileLocationType=WEB_UPLOAD, contentId=123, folder=/uploads, filename=data.csv, fileFormat=DELIMITED, delimiter=,, skipFirstRow=false, dataSetMode=create, dataSetType=AUDIENCE, mappings=[{attributeName=email, columnHeader=Email, mappingMode=header}], additionalOptions={"dateFormat":"ISO_8601"}, notifications=[{email=user@example.com,onSuccess=true,onFailure=true}]

Example 2: Add/update existing reference set records from an SFTP JSONL file

jobName=updateRefSet, importType=ADD_UPDATE, fileLocationType=SFTP, folder=/data, filename=refset.jsonl, fileFormat=JSONL, dataSetMode=existing, dataSetId=RS_456, mappings=[{attributeName=email, columnHeader=email, mappingMode=header}], notifications=[{email=admin@example.com,onSuccess=true,onFailure=true}]

Example 3: Replace a product catalog with a delimited file and create a segment

jobName=replaceCatalog, importType=REPLACE, fileLocationType=WEB_UPLOAD, contentId=789, fileFormat=DELIMITED, delimiter=\t, skipFirstRow=true, dataSetMode=create, dataSetName=ProductCatalog_2025, dataSetType=PRODUCT_CATALOG, additionalOptions={"createSegment":true,"segmentName":"NewSegment"}, notifications=[{email=ops@example.com,onSuccess=true,onFailure=true}]

Links

Discussion