Integration Instances API

Integrations are a new feature currently in beta-test: this API is subject to change without notice. Visit App Builder NodeJS for more information on integrations in 4me.

List integration instances

List all integration instances for an account:

GET /integration_instances

Response

Status: 200 OK
[
  {
    "id": 1,
    "integration": {
      "reference": "note-dispatcher",
      "id": 1
    },
    "customer_account": {
      "id": "wdc",
      "name": "Widget Data Center"
    },
    "created_at": "2021-04-13T04:36:10-05:00",
    "updated_at": "2021-04-13T04:36:10-05:00",
    "enabled_by_customer": true,
    "...": "..."
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of integration instances.

Predefined Filters

The following predefined filters are available:

Collection Fields

By default the following fields will appear in collections of integration instances:

created_at id nodeID updated_at disabled customer_account integration enabled_by_customer

Obtain a different set of fields using the ?fields= parameter.

Sorting

By default a collection of integration instances is not sorted.

The following fields are accepted by the ?sort= parameter:

id created_at updated_at

Get a single integration instance

GET /integration_instances/:id

Response

Status: 200 OK
{
  "id": 1,
  "integration": {
    "reference": "note-dispatcher",
    "id": 1
  },
  "customer_account": {
    "id": "wdc",
    "name": "Widget Data Center"
  },
  "created_at": "2021-04-13T04:36:10-05:00",
  "updated_at": "2021-04-13T04:36:10-05:00",
  "enabled_by_customer": true,
  "...": "..."
}

The response contains these fields.

Fields

created_at
Readonly datetime — The date and time at which the integration instance was created.
custom_fields
Optional custom fields — Custom fields provided in JSON format by the UI Extension version that is linked to the integration.
customer_account
Readonly reference to Account — Account this integration instance is for.
customer_representative
Required reference to Person — The contact person regarding this integration instance.
disabled
Optional boolean, default: false — The Disabled box is checked when the integration instance is disabled by the provider of the Integration. This means the automation rules, webhook, application token of the instance in the customer’s account are disabled.
enabled_by_customer
Optional boolean — The Enabled by customer box is checked when the customer allows the integration to operate in their account. This means the automation rules, webhook, application token of the instance in the customer’s account are enabled.
id
Readonly integer — The unique ID of the integration instance.
integration
Required reference to Integration — This field references the Integration this instance belongs to.
suspended
Optional boolean, default: false — The Suspended box must be checked when either the provider or customer wants to disable the integration instance, but the other party is allowed to enable it again. This means the automation rules, webhook, application token of the instance in the customer’s account are disabled.
suspension_comment
Optional text (max 64KB) — The Suspension comment field is used to describe why the integration instance was suspended.
updated_at
Readonly datetime — The date and time of the last update of the integration instance. If the integration instance has no updates it contains the created_at value.
webhook
Optional reference to Webhook — This field references the webhook created for the integration in the customer’s account.
webhook_policy
Optional reference to Webhook Policy — This field references the webhook policy created for the integration in the customer’s account.