Skip to main content
POST
/
integrations
Create a new integration
curl --request POST \
  --url https://api.matia.io/v1/integrations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "destinationId": "<string>",
  "destinationSchema": "<string>",
  "replicationFrequency": "<string>",
  "onSchemaUpdate": "<string>",
  "enabled": true,
  "sourceConfig": {
    "type": "postgres",
    "name": "<string>",
    "authMethod": "<string>",
    "connection": {
      "username": "<string>",
      "password": "<string>",
      "hostname": "<string>",
      "port": 123,
      "database": "<string>",
      "slot": "<string>",
      "publication": "<string>"
    },
    "connectionType": "<string>",
    "owners": [
      "<string>"
    ]
  },
  "sourceSettings": {
    "max_clients": 123,
    "incremental_mode": "<string>"
  }
}
'
{
  "id": 123,
  "code": "<string>",
  "message": "<string>",
  "data": {
    "id": "<string>"
  }
}
This endpoint allows you to create a new integration between a source and destination. The integration configuration varies based on the connector type you’re using.

Connector-Specific Configuration

Select your connector type to see its specific configuration requirements:

Authorizations

x-api-key
string
header
required

Body

application/json
destinationId
string
required
destinationSchema
string
required
replicationFrequency
string
required
onSchemaUpdate
string
required
enabled
boolean
required
sourceConfig
object
required
sourceSettings
object
required

Response

Integration created successfully

id
integer<int64>
required

Identification number of the integration

code
string
message
string
data
object