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 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