Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. Jobs
  5. Marketingcloud Import

Marketingcloud Import

markdownView as Markdown

Create and manage data import and export jobs.

MarketingcloudImport: Create job

POSThttps://api.lytics.io/v2/job/marketingcloud-import

Create a MarketingcloudImport job

Sample Request
12345678910111213141516171819202122232425262728293031
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "activities": [
      "string"
    ],
    "activity": true,
    "activity_end": "string",
    "activity_start": "string",
    "business_units": [
      "string"
    ],
    "subscriber_attributes": true,
    "subscriber_properties": [
      "string"
    ],
    "subscribers": true,
    "subscribers_end": "string",
    "subscribers_start": "string"
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|201 Created
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "activities": [
        "string"
      ],
      "activity": true,
      "activity_end": "string",
      "activity_start": "string",
      "business_units": [
        "string"
      ],
      "subscriber_attributes": true,
      "subscriber_properties": [
        "string"
      ],
      "subscribers": true,
      "subscribers_end": "string",
      "subscribers_start": "string"
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

MarketingcloudImport: Get job

GEThttps://api.lytics.io/v2/job/marketingcloud-import/{id}

Get the summary of a MarketingcloudImport job

Sample Response
Status|200 OK
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "activities": [
        "string"
      ],
      "activity": true,
      "activity_end": "string",
      "activity_start": "string",
      "business_units": [
        "string"
      ],
      "subscriber_attributes": true,
      "subscriber_properties": [
        "string"
      ],
      "subscribers": true,
      "subscribers_end": "string",
      "subscribers_start": "string"
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

MarketingcloudImport: Update job

PUThttps://api.lytics.io/v2/job/marketingcloud-import/{id}

Update a MarketingcloudImport job

Sample Request
12345678910111213141516171819202122232425262728293031
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "activities": [
      "string"
    ],
    "activity": true,
    "activity_end": "string",
    "activity_start": "string",
    "business_units": [
      "string"
    ],
    "subscriber_attributes": true,
    "subscriber_properties": [
      "string"
    ],
    "subscribers": true,
    "subscribers_end": "string",
    "subscribers_start": "string"
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|200 OK
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "activities": [
        "string"
      ],
      "activity": true,
      "activity_end": "string",
      "activity_start": "string",
      "business_units": [
        "string"
      ],
      "subscriber_attributes": true,
      "subscriber_properties": [
        "string"
      ],
      "subscribers": true,
      "subscribers_end": "string",
      "subscribers_start": "string"
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
Hide Parameters

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.activitiesoptionalstring[]

Select a subset of activities to import. Leave empty to import all activities

config.activityoptionalboolean

Import new Marketing Cloud subscriber activity

config.activity_endoptionalstring
config.activity_startoptionalstring

Set in conjunction with Activity Backfill End Date to pull in a set of activity by date

config.business_unitsoptionalstring[]

Select a set of business units to import. Leave empty to import from all business units. However, leaving empty may cause the import to pull in the "All" subscriber list in Marketing Cloud depending on your auth settings. To ensure importing from only the business units listed in the auth, you must select all the business units here

config.subscriber_attributesoptionalboolean

Check this box if you have custom subscriber attributes to import. This will cause your imports to take a longer time.

config.subscriber_propertiesoptionalstring[]
config.subscribersoptionalboolean

Import new Marketing Cloud subscriber data

config.subscribers_endoptionalstring
config.subscribers_startoptionalstring

Set in conjunction with Subscriber Backfill End Date to pull in a set of subscribers by Created Date

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring
Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.activitiesoptionalstring[]

Select a subset of activities to import. Leave empty to import all activities

config.activityoptionalboolean

Import new Marketing Cloud subscriber activity

config.activity_endoptionalstring
config.activity_startoptionalstring

Set in conjunction with Activity Backfill End Date to pull in a set of activity by date

config.business_unitsoptionalstring[]

Select a set of business units to import. Leave empty to import from all business units. However, leaving empty may cause the import to pull in the "All" subscriber list in Marketing Cloud depending on your auth settings. To ensure importing from only the business units listed in the auth, you must select all the business units here

config.subscriber_attributesoptionalboolean

Check this box if you have custom subscriber attributes to import. This will cause your imports to take a longer time.

config.subscriber_propertiesoptionalstring[]
config.subscribersoptionalboolean

Import new Marketing Cloud subscriber data

config.subscribers_endoptionalstring
config.subscribers_startoptionalstring

Set in conjunction with Subscriber Backfill End Date to pull in a set of subscribers by Created Date

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring