POST /automation/v1/automations/trigger

Start a marketing automation inside Marketing Cloud’s Automation Studio with the trigger start source and Trigger API. When you upload a file, the Trigger API request you set up passes the file details to be evaluated by Automation Studio.

You can queue a maximum of 200 Trigger requests at a time for the same MID.

Required Scopes

Installed Packages > Automation > Automations > Write, execute

JSON Parameters

NameTypeDescription
fileTransferLocationKeystringRequired. The file location API identifier.
filenamestringRequired. The name of the file.
relativepathstringThe relative folder path from the top-level container, not including the bucket or container name.
deduplicationKeystringA key, formatted as an alphanumeric with dashes, such as the AWS eTag or versionID. Subsequent requests within the past 24 hours that use a previously used deduplicationKey are ignored.

When you upload a file to a folder with a dynamic structure or naming convention, we recommend that you create a file location at the root bucket/container/directory. Then, use the relativepath parameter to dynamically specify the path to the file.

Example Request with Response

Example Request

Example Response