Create Integration

This request creates and configures a new integration instance within the system. Integrations allow the platform to communicate with external services, enabling automated data exchange, event notifications, and execution of external processes.

When an integration is created, configuration parameters such as the execution environment, authentication token, webhook endpoint, and key mapping behavior are defined. These settings ensure secure communication and determine how the system interacts with the external service.

Request Body Fields

integration (integer)

The identifier of the integration type that will be configured.
This value determines which external service or integration module will be used.

Data Configuration

data.environment (string)

Defines the environment where the integration will operate.

Possible values:

stage – Integration configured for staging/testing environment.

production – Integration configured for the production environment.

data.changeKeys (boolean)

Indicates whether the system should automatically adjust or map field keys when sending or receiving data from the external integration.

true – The system will change or map keys automatically.

false – Keys will be used exactly as defined.

data.token (string)

Authentication token used to authorize requests between the platform and the external integration service.

data.webhookCatcherEndpoint (string)

The webhook endpoint that will receive callbacks or events from the external service.
This URL is used for event notifications, status updates, or responses generated by the integration.

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

API Key

Add parameter in header

en-workspace

Example:

en-workspace: ********************

curl --location --request POST 'https://api-develop.enspace.io/workspace-integrations' \ --header 'x-api-key: <api-key>' \ --header 'en-workspace: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id": 15, "data": { "changeKeys": false, "environment": "stage", "webhookCatcherEndpoint": "https://api-develop.enspace.io/webhooks/certisign" }, "integration": { "id": 1, "name": "Certisign", "description": "integrations.certisign.description", "category": "integrations.certisign.category", "slug": "certisign", "created_at": "2025-06-17T15:40:10.353Z", "updated_at": "2025-06-17T15:40:10.353Z", "media": [] }, "status": "active", "created_at": "2026-03-11T20:02:10.058Z", "updated_at": "2026-03-11T20:02:10.068Z" }'

{ "type": "Lorem laboris dolore", "items": { "type": "eiusmod in", "properties": { "id": { "type": "commodo" }, "data": { "type": "occaecat ut ea eiusmod", "properties": { "changeKeys": { "type": "eu deserunt eiusmod" }, "environment": { "type": "aliqua sint culpa enim" }, "webhookCatcherEndpoint": { "type": "fugiat" } }, "required": [ "ea sint dolor reprehenderit" ], "x-apidog-orders": [ "eu reprehenderit exercitation cillum", "deserunt", "aliqua" ] }, "integration": { "type": "dolore est non", "properties": { "id": { "type": "dolore deserunt in" }, "name": { "type": "sit laboris qui" }, "description": { "type": "fugiat ut laborum" }, "category": { "type": "qui" }, "slug": { "type": "velit" }, "created_at": { "type": "dolore ullamco in consequat officia" }, "updated_at": { "type": "quis nisi magna elit" } }, "required": [ "officia deserunt" ], "x-apidog-orders": [ "ut cillum exercitation", "sint id nulla fugiat ex" ] }, "status": { "type": "consectetur" }, "created_at": { "type": "id velit in ut" }, "updated_at": { "type": "non aliqua" } }, "x-apidog-orders": [ "dolore", "sunt sit minim in", "ut" ], "required": [ "sed", "ipsum in exercitation pariatur" ] } }

Create Integration

Create Integration#

Request Body Fields#

integration (integer)#

Data Configuration#

data.environment (string)#

data.changeKeys (boolean)#

data.token (string)#

data.webhookCatcherEndpoint (string)#

Request

Responses

Create Integration

Request Body Fields

integration (integer)

Data Configuration

data.environment (string)

data.changeKeys (boolean)

data.token (string)

data.webhookCatcherEndpoint (string)