Skip to main content

Account Events

EventDescription
integrated_account:createdAccount connection started
integrated_account:activeAccount is ready for use
integrated_account:updatedAccount details changed
integrated_account:post_install_errorPost-install steps failed
integrated_account:validation_errorValidation failed
integrated_account:post_connect_form_submittedUser submitted RapidForm
integrated_account:authentication_errorCredentials invalid or expired
integrated_account:reactivatedAccount recovered from auth error

Sync Job Events

EventDescription
sync_job_run:createdSync job run created
sync_job_run:startedSync job started executing
sync_job_run:recordData record received
sync_job_run:record_errorError fetching a record
sync_job_run:rate_limitedHit rate limit, pausing
sync_job_run:completedSync job finished successfully
sync_job_run:failedSync job failed
sync_job_run:updatedSync job run updated
sync_job_run:deletedSync job run deleted

Record Events

EventDescription
record:createdNew record in underlying service
record:updatedRecord changed
record:deletedRecord removed
Record events require webhook configuration on the underlying integration.

Event Payload Examples

Account Active

{
  "event": "integrated_account:active",
  "payload": {
    "id": "acc_123",
    "tenant_id": "customer_456",
    "integration": {
      "name": "shiphero",
      "label": "ShipHero"
    }
  }
}

Sync Completed

{
  "event": "sync_job_run:completed",
  "payload": {
    "id": "run_789",
    "sync_job_id": "job_123",
    "integrated_account_id": "acc_456",
    "records_synced": 150,
    "duration_ms": 5420
  }
}