Skip to main content

Trigger events

Trigger event subscriptions​

In addition to data driven events, Actito produces events when internal operations occur.
Those events are named "triggers" and happen on many Actito modules.

Available triggers​

ETL executions​

  • STARTED

Be notified as soon as a scheduled or triggered etl execution is started.

  • FINISHED

Be notified as soon as a scheduled or triggered etl execution is finished.

Exports​

  • FINISHED

Be notified as soon as an automated export (periodic or incremental) is finished.

Custom actions​

  • TRIGGER

Be notified as soon as a profile reaches your custom action in an Actito scenario.

Payload samples​

ETL Executions​

Trigger event : All finished etl execution of etl with id 123456

ONE_BY_ONE​

{
  "id": "95f1cebc-4dd7-4246-83a1-164d8da8c583",
  "data": {
    "etl.id": "123456",
    "etl.executionId": "123654987",
    "etl.executionStatus": "SUCCESS",
    "_links": {
      "etlExecution": {
        "href": "/mass-imports/v5/entities/MyEntity/etl-executions/123654987"
      },
      "etl": {
        "href": "/mass-imports/v5/entities/MyEntity/etls/123456"
      }
    }
  },
  "_links": {
    "webhook": {
      "href": "/webhooks/v4/entity/MyEntity/webhookSubscription/123789654"
    }
  }
}

BULK​

{
 "id": "201373e4-22f9-4165-b394-6223b692eebc",
 "data": [
   {
     "etl.id": "123456",
     "etl.executionId": "123654987",
     "etl.executionStatus": "SUCCESS",
     "_links": {
       "etlExecution": {
         "href": "/mass-imports/v5/entities/MyEntity/etl-executions/123654987"
       },
       "etl": {
         "href": "/mass-imports/v5/entities/MyEntity/etls/123456"
       }
     }
   },
   {
     "etl.id": "123456",
     "etl.executionId": "123654988",
     "etl.executionStatus": "WITH_ERROR",
     "_links": {
       "etlExecution": {
         "href": "/mass-imports/v5/entities/MyEntity/etl-executions/123654988"
       },
       "etl": {
         "href": "/mass-imports/v5/entities/MyEntity/etls/123456"
       }
     }
   }
 ],
 "_links": {
   "webhook": {
     "href": "/webhooks/v4/entity/MyEntity/webhookSubscription/2"
   }
 }
}

​

Export execution​

Trigger event: all executions of the export with id 123456

ONE_BY_ONE

{
  "_links": {
    "webhook": {
      "href": "/webhooks/v4/entity/actito/webhookSubscription/157"
    }
  },
  "_audit": {
    "createdAt": "2025-02-26T11:41:06+01:00",
    "updatedAt": "2025-02-26T11:41:06+01:00"
  },
  "id": "a2875e2d-9eb7-4daa-80df-fd4bdb729b06",
  "data": {
    "export.fileTransferConfigId": 31,
    "export.fileTransferLocationId": 6,
    "export.executionFileName": "20250226_Actito_ECOMMERCE_EMAIL_CAMPAIGN_OPENING.zip",
    "_links": {
      "export": {
        "href": "/exports/v5/entities/newmail/exports/123456"
      }
    },
    "export.executionStatus": "SUCCESS",
    "export.id": 123456,
    "export.executionId": 213494
  }
}

Custom actions​

​ Trigger event : All triggered event for custom action with id 123456

ONE_BY_ONE​

{
  "id": "95f1cebc-4dd7-4246-83a1-164d8da8c583",
  "data": {
    "actionParameters.campaignId": "987654",
    "actionParameters.campaignGroup": "Notifications",
    "profileAttributes.businessId": "4f5427b0-0134-4f4b-971a-98a9f03d0ff5",
    "profileAttributes.emailAddress": "john.smith@actito.com",
    "scenarioExecutionContextAttributes.startEventType": "CUSTOM_TABLE#NEW_RECORD",
    "scenarioExecutionContextAttributes.startEventId": "e46a7856-3e4d-4a88-baa5-a3d599b30550",
    "_links": {
      "notifyOK": {
        "href": "https://www.actito.com/ca/OK_6946_67617411_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5jaGdhcmRlbi5iZS9mci9teWx1bmNoZ2FyZGVu"
      },
      "notifyKO": {
        "href": "https://www.actito.com/ca/KO_6946_67617411_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5ds4d45sfJFJ5iZS9mci9teWx1bmNoZ2FyZGVu"
      },
      "customAction": {
        "href": "/custom-actions/v5/entities/MyEntity/custom-actions/123456"
      }
    }
  },
  "_links": {
    "webhook": {
      "href": "/webhooks/v4/entity/MyEntity/webhookSubscription/123987456"
    }
  }
}

BULK​

{
 "id": "201373e4-22f9-4165-b394-6223b692eebc",
 "data": [
   {
     "actionParameters.campaignId": "987654",
     "actionParameters.campaignGroup": "Notifications",
     "profileAttributes.businessId": "b4a0cb14-84af-4549-ba36-2e9ad4a98ac0",
     "profileAttributes.emailAddress": "john.smith@actito.com",
     "scenarioExecutionContextAttributes.startEventType": "CUSTOM_TABLE#NEW_RECORD",
     "scenarioExecutionContextAttributes.startEventId": "e46a7856-3e4d-4a88-baa5-a3d599b30550",
     "_links": {
       "notifyOK": {
         "href": "https://www.actito.com/ca/OK_6946_67617411_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5jaGdhcmRlbi5iZS9mci9teWx1bmNoZ2FyZGVu"
       },
       "notifyKO": {
         "href": "https://www.actito.com/ca/KO_6946_67617411_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5ds4d45sfJFJ5iZS9mci9teWx1bmNoZ2FyZGVu"
       },
       "customAction": {
         "href": "/custom-actions/v5/entities/MyEntity/custom-actions/123456"
       }
     }
   },
   {
     "actionParameters.campaignId": "987654",
     "actionParameters.campaignGroup": "Notifications",
     "profileAttributes.businessId": "4f5427b0-0134-4f4b-971a-98a9f03d0ff5",
     "profileAttributes.emailAddress": "jane.smith@actito.com",
     "scenarioExecutionContextAttributes.startEventType": "CUSTOM_TABLE#NEW_RECORD",
     "scenarioExecutionContextAttributes.startEventId": "c9152856-856e-41ff-9a89-1c7da05e1f76",
     "_links": {
       "notifyOK": {
         "href": "https://www.actito.com/ca/OK_6946_67617412_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5jaGdhcmRlbi5iZS9mci9teWx1bmNoZ2FyZGVu"
       },
       "notifyKO": {
         "href": "https://www.actito.com/ca/KO_6946_67617412_4JK5QKY19YGM_54501_aHR0cDovL3d3dy5sdW5ds4d45sfJFJ5iZS9mci9teWx1bmNoZ2FyZGVu"
       },
       "customAction": {
         "href": "/custom-actions/v5/entities/MyEntity/custom-actions/123456"
       }
     }
   }
 ],
 "_links": {
   "webhook": {
     "href": "/webhooks/v4/entity/MyEntity/webhookSubscription/123987456"
   }
 }
}