Sync actions

In this topic:

Sync actions are parameters that you declare in an import or export definition that specify additional actions Eloqua should take when you import or export data.

The following are supported sync actions:

Sync action reference for contacts

Add to contact list

Action Destination Status
add {{ContactList[<id>]}} n/a

Example:

{
  "action": "add",
  "destination": "{{ContactList[12345]}}"
}

Remove from contact list

Action Destination Status
remove {{ContactList[<id>]}} n/a

Example:

{
  "action": "remove",
  "destination": "{{ContactList[12345]}}"
}

Subscribe to email group

Action Destination Status
setStatus {{EmailGroup[<id>]}} subscribed

Example:

{
  "action": "setStatus",
  "destination": "{{EmailGroup[12345]}}",
  "status": "subscribed"
}

Unsubscribe from email group:

Action Destination Status
setStatus {{EmailGroup[<id>]}} unsubscribed

Example:

{
  "action": "setStatus",
  "destination": "{{EmailGroup[12345]}}",
  "status": "unsubscribed"
}

Global subscribe (to all email groups)

Action Destination Status
setStatus {{GlobalSubscribe}} subscribed

Example:

{
  "action": "setStatus",
  "destination": "{{GlobalSubscribe}}",
  "status": "subscribed"
}

Global unsubscribe (from all email groups)

Action Destination Status
setStatus {{GlobalSubscribe}} unsubscribed

Example:

{
  "action": "setStatus",
  "destination": "{{GlobalSubscribe}}",
  "status": "unsubscribed"
}

AppCloud decision response

Action Destination Status Update All Records
setStatus {{DecisionInstance(<id>).Execution[<id>]}} yes / no / errored / invalid / permission true / false

Example:

{
  "action": "setStatus",
  "destination": "{{DecisionInstance(da6ed61da73441dba1349582a4fa8a2c).Execution[12345]}}",
  "status": "yes",
  "updateAll": false
}

AppCloud action response

Action Destination Status Update All Records
setStatus {{ActionInstance(<id>).Execution[<id>]}} active / complete / errored / invalid / permission true / false

Example:

{
  "action": "setStatus",
  "destination": "{{ActionInstance(f82d50cd86a94fcab37e4ec9a98b0339).Execution[12345]}}",
  "status": "complete",
  "updateAll": true
}

AppCloud feeder response

Action Destination Status
setStatus {{FeederInstance[<id>]}} active / complete / errored

Example:

{
  "action": "setStatus",
  "destination": "{{FeederInstance(da6ed61da73441dba1349582a4fa8a2c)}}",
  "status": "complete"
}

Sync action reference for custom objects

AppCloud decision response (program canvas only)

Action Destination Status Update All Records
setStatus {{DecisionInstance(<id>).Execution[<id>]}} yes / no / errored / invalid / permission true / false

Example:

{
  "action": "setStatus",
  "destination": "{{DecisionInstance(da6ed61da73441dba1349582a4fa8a2c).Execution[12345]}}",
  "status": "yes",
  "updateAll": false
}

AppCloud action response (program canvas only)

Action Destination Status Update All Records
setStatus {{ActionInstance(<id>).Execution[<id>]}} active / complete / errored / invalid / permission true / false

Example:

{
  "action": "setStatus",
  "destination": "{{ActionInstance(f82d50cd86a94fcab37e4ec9a98b0339).Execution[12345]}}",
  "status": "complete",
  "updateAll": true
}

AppCloud Feeder Response (Program Canvas only)

Action Destination Status
setStatus {{FeederInstance[<id>]}} active / complete / errored

Example:

{
  "action": "setStatus",
  "destination": "{{FeederInstance(da6ed61da73441dba1349582a4fa8a2c)}}",
  "status": "complete"
}

Sync action reference for accounts

Add to account list

Action Destination Status
add {{AccountList[<id>]}} n/a

Example:

{
  "action": "add",
  "destination": "{{AccountList[12345]}}"
}

Remove from account list

Action Destination Status
remove {{AccountList[<id>]}} n/a

Example:

{
  "action": "remove",
  "destination": "{{AccountList[12345]}}"
}

Sync action reference for email addresses

Email addresses global unsubscribe

Action Destination Status
setStatus {{GlobalSubscribe}} unsubscribed

Example:

{
  "action": "setStatus",
  "destination": "{{GlobalSubscribe}}",
  "status": "unsubscribed"
}

Email addresses set bounceback

Action Destination Status
setStatus {{Bounceback}} bounced

Example:

{
  "action": "setStatus",
  "destination": "{{Bounceback}}",
  "status": "bounced"
}

Sync action app statuses

Here is an explanation of sync action app statuses, the status displayed, and when each status is set.

Sync action app status Status Displayed Set When
active Being processed by app Step records are successfully exported.
complete N/A Records have been successfully processed.
errored Status 'Error' set by app There are errors not related to configuration or Manage Data Export Permission.
invalid Invalid app configuration There is a configuration error. For example, a field with an incorrect data type has been selected to be mapped.
permission Eloqua configuration error - Manage Data Export Permission The Bulk API User does not have the "Manage Data Export" action permission. If the app encounters a 403 error when attempting to export records this would indicate the Bulk API User does not have the "Manage Data Export" action permission.

Learn more

Oracle Eloqua Bulk API