---
sidebar: auto
---

# Loom Events

Here you will find a list of the Loom Events provided by the zaikio.

## `zaikio.revoked_access_token`

This event will be triggered every time an access token is revoked (e.g. because the user was banned). You must maintain this token in a list of revoked access tokens (for at least 1 hour).

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.revoked_access_token",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "payload": {
    "access_token_id":"b1a2eaa9-11ba-4cab-8580-40f091e37742" // Access Token ID (JTI) that was revoked
  },
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

## `zaikio.established_connection`

This event will be triggered every time an organization or person establishes a connection with your app, that did not have an active connection before. This event is only sent to your app.

The subject contains the subject to which the connection was established. It can be a person or an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

## `zaikio.connection_changed`

This event will be triggered every time an organization or person changes the actual or requested OAuth scopes of a connection with your app. This can for example happen, if the subject connects to another app, that your app requested scopes for or because another connection was removed and some scopes are not available anymore or because the subject granted requested scopes through Zaikio.

This event is only sent to your app.

The subject contains the subject to which the connection was established. It can be a person or an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251471b",
  "name": "zaikio.connection_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

## `zaikio.revoked_connection`

This event will be triggered every time an organization or person revoked a connection with your app, that did have an active connection before. This event is only sent to your app.

The subject contains the subject to which the connection was originally established. It can be a person or an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

## `zaikio.organization_details_changed`

This event will be triggered every time organization details such as logo, kind or name changed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "link": "https://hub.sandbox.zaikio/api/v1/organization"
}
```

## `zaikio.person_details_changed`

This event will be triggered every time a person's profile changed (such as name, language, avatar, ...). This event is triggered with a `Person` subject. If you want to listen to this event for an organization use `member_details_changed`.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.person_details_changed",
  "subject": "Per/dee4c43d-6a61-4b79-99fd-0035ddd6b887",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "link": "https://hub.sandbox.zaikio/api/v1/person"
}
```


## `zaikio.subscription_*`

We offer 5 events for subscriptions: created, plan_changed, payment_failed, payment_issues_resolved and canceled.

### `zaikio.subscription_created`

This event will be triggered every time a subscription was created for your app. This event is not fired, if a plan was upgraded or downgraded (instead it will fire `zaikio.subscription_plan_changed`).

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_created",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "advanced"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}
```

### `zaikio.subscription_plan_changed`

This event will be triggered every time an existing subscription changed its plan. **This subscription has to be provisioned again.**

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_plan_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}
```

### `zaikio.subscription_payment_failed`

This event will be triggered when an invoice for a subscription was not paid within 1 week. You might forbid the organization access to premium features of your app.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_payment_failed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}
```

### `zaikio.subscription_payment_issues_resolved`

This event will be triggered after a `zaikio.subscription_payment_failed` was triggered before but the subscription's payment went back to normal. You should give the organization access to premium features of your app again.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_payment_issues_resolved",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}
```

### `zaikio.subscription_canceled`

This event will be triggered when a susbcription was canceled by the user. You should disable all premium features of your app for this organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_canceled",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  }
}
```

### `zaikio.billing_address_changed`

This event will be triggered when an organization changed its billing address.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.billing_address_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

### `zaikio.means_of_payment_changed`

This event will be triggered when an organization changed its default means of payment.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.means_of_payment_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}
```

## `zaikio.machine_*`

We offer 4 events for machines: added, site_changed, details_changed and removed.

### `zaikio.machine_added`

This event will be triggered every time a machine was assigned to an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.machine_details_changed`

This event will be triggered every time the details such as kind, manufacturer or specification of a machine were updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.machine_site_changed`

This event will be triggered every time the site of a machine was changed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_site_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.machine_removed`

This event will be triggered every time a machine was removed from an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  }
}
```

## `zaikio.availability_*`

We offer 3 events for availabilities: added, changed and removed.

### `zaikio.availability_added`

This event will be triggered every time an availability is assigned to an asset (machine or specialist).

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.availability_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/80ef6969-0b4d-4959-8833-875d601f0922/availabilities/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.availability_changed`

This event will be triggered every time an availability is modified.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
    "name": "zaikio.availability_changed",
    "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
    "timestamp": "2019-11-26T10:58:09.664Z",
    "version": "1.0",
    "received_at": "2019-11-26T10:58:09.664Z",
    "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
      "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/80ef6969-0b4d-4959-8833-875d601f0922/availabilities/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.availability_removed`

This event will be triggered every time a availability is removed from an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
    "name": "zaikio.availability_removed",
    "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
    "timestamp": "2019-11-26T10:58:09.664Z",
    "version": "1.0",
    "received_at": "2019-11-26T10:58:09.664Z",
    "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
      "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  }
}
```

## `zaikio.specialist_*`

We offer 4 events for specialist assets: added, site_changed, details_changed and removed.

### `zaikio.specialist_added`

This event will be triggered every time a specialist was assigned to an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.specialist_details_changed`

This event will be triggered every time the details such as kind, vendor or specification of a specialist asset were updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.specialist_site_changed`

This event will be triggered every time the site of a specialist was changed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_site_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.specialist_removed`

This event will be triggered every time a specialist asset was removed from an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  }
}
```


## `zaikio.organization_*`

We offer 3 events for organization members where the person is the subject: joined, roles_updated and left.

### `zaikio.organization_joined`

This event will be triggered every time a person was added to an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_joined",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a",
    "roles": 1 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/person/organization_memberships"
}
```

### `zaikio.organization_roles_updated`

This event will be triggered every time the roles of a member changed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_roles_updated",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a",
    "roles": 2 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/person/organization_memberships"
}
```

### `zaikio.organization_left`

This event will be triggered every time a person was removed from an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_left",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a"
  }
}
```


## `zaikio.member_*`

We offer 4 events for organization members: joined, roles_updated, member_details_changed and left. These events are fired the same as `zaikio.organization_*` but the subject is the organisation and not the person.

### `zaikio.member_joined`

This event will be triggered every time a person was added to an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_joined",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922",
    "roles": 1 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.member_roles_updated`

This event will be triggered every time the roles of a member changed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_roles_updated",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922",
    "roles": 1 // new roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.member_details_changed`

This event will be triggered every time a member's profile changed (such as name, language, avatar, ...)

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```


### `zaikio.member_left`

This event will be triggered every time a person was removed from an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_left",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  }
}
```

## `zaikio.site_*`

We offer 4 events for sites: added, details_changed, address_changed and removed.

### `zaikio.site_added`

This event will be triggered every time a site was added to an organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.site_details_changed`

This event will be triggered every time a site name was updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.site_address_changed`

This event will be triggered every time an address of a site was updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_address_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.site_removed`

This event will be triggered every time a site was removed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}
```


## `zaikio.business_relationship_*`

We offer 3 events for business relationships: added, changed and removed.

### `zaikio.business_relationship_added`

This event will be triggered every time a business relationship was added to an owner organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/business_relationships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.business_relationship_changed`

This event will be triggered every time a business relationship name was updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/business_relationships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}
```

### `zaikio.business_relationship_removed`

This event will be triggered every time a business relationship was removed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  }
}
```

# Vendor Events

## Connections

### `zaikio.established_connection_to_vendor`

This event will be triggered every time a person or organisation connected to an app of the vendor. The subject is the vendor organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection_to_vendor",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "connectable": "Org/558f9a80-5fd1-444a-8fd2-a68cf29a1b52",
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}
```

### `zaikio.revoked_connection_to_vendor`

This event will be triggered every time a person or organisation revoked a connection to an app of the vendor. The subject is the vendor organisation.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.revoked_connection_to_vendor",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "connectable": "Org/558f9a80-5fd1-444a-8fd2-a68cf29a1b52",
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}
```

## `zaikio.app_*`

We offer 3 events for apps: added, changed and removed.

### `zaikio.app_added`

This event will be triggered every time an app was added to a vendor organization.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/apps/386725c0-b9b7-4d91-827f-0a4969904311"
}
```

### `zaikio.app_changed`

This event will be triggered every time app details such as name were updated.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/apps/386725c0-b9b7-4d91-827f-0a4969904311"
}
```

### `zaikio.app_removed`

This event will be triggered every time an app was removed.

Example event:

```js
{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}
```