SDK Apps > Connections

List App Connections

get

Retrieves a list of all apps available to the user.

Authorizations
Path parameters
SDK_appNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Responses
200
Successful response
application/json
get
GET /api/v2/sdk/apps/{SDK_appName}/connections HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "connections": [
    {
      "name": "testConnection",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-1",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-12",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-13",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-14",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-15",
      "label": "Test Connection",
      "type": "oauth"
    },
    {
      "name": "postman-test-app-6-16",
      "label": "Test Connection",
      "type": "oauth"
    }
  ]
}

Create Connection

post

Retrieves a list of all apps available to the user.

Authorizations
Path parameters
SDK_appNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Content-TypestringOptionalExample: application/json
Body
typestringOptional
labelstringOptional
Responses
200
Successful response
application/json
post
POST /api/v2/sdk/apps/{SDK_appName}/connections HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "type": "basic",
  "label": "Hello Charlie"
}
200

Successful response

{
  "appConnection": {
    "name": "custom-app-13",
    "label": "Main Connection",
    "type": "basic"
  }
}

Get Connection

get

Retrieves a list of all apps available to the user.

Authorizations
Path parameters
SDK_connectionNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Responses
200
Successful response
application/json
get
GET /api/v2/sdk/apps/connections/{SDK_connectionName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appConnection": {
    "name": "custom-app-13",
    "label": "Main Connection",
    "type": "basic"
  }
}

Delete Connection

delete

Retrieves a list of all apps available to the user.

Authorizations
Path parameters
SDK_connectionNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Responses
200
Successful response
application/json
delete
DELETE /api/v2/sdk/apps/connections/{SDK_connectionName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appConnection": "custom-app-13"
}

Update Connection

patch

Retrieves a list of all apps available to the user.

Authorizations
Path parameters
SDK_connectionNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Content-TypestringOptionalExample: application/json
Body
labelstringOptional
Responses
200
Successful response
application/json
patch
PATCH /api/v2/sdk/apps/connections/{SDK_connectionName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "label": "Main Connection"
}
200

Successful response

{
  "appConnection": {
    "name": "charlie-1",
    "label": "Main Connection",
    "type": "basic"
  }
}

Get Connection Section

get

Available sections: api, parameters, scopes, scope, install, installSpec

Authorizations
Path parameters
SDK_connectionNamestringRequired
SDK_connectionSectionstringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Responses
200
Successful response
application/json
get
GET /api/v2/sdk/apps/connections/{SDK_connectionName}/{SDK_connectionSection} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "authorize": {
    "qs": {
      "scope": "{{join(oauth.scope, ',')}}",
      "client_id": "{{ifempty(parameters.clientId, common.clientId)}}",
      "redirect_uri": "{{oauth.redirectUri}}",
      "response_type": "code"
    },
    "url": "https://www.example.com/oauth/authorize",
    "response": {
      "temp": {
        "code": "{{query.code}}"
      }
    }
  },
  "token": {
    "url": "https://www.example.com/api/token",
    "body": {
      "code": "{{temp.code}}",
      "client_id": "{{ifempty(parameters.clientId, common.clientId)}}",
      "grant_type": "authorization_code",
      "redirect_uri": "{{oauth.redirectUri}}",
      "client_secret": "{{ifempty(parameters.clientSecret, common.clientSecret)}}"
    },
    "type": "urlencoded",
    "method": "POST",
    "response": {
      "data": {
        "accessToken": "{{body.access_token}}"
      }
    },
    "log": {
      "sanitize": [
        "request.body.code",
        "request.body.client_secret",
        "response.body.access_token"
      ]
    }
  },
  "info": {
    "url": "https://www.example.com/api/whoami",
    "headers": {
      "authorization": "Bearer {{connection.accessToken}}"
    },
    "response": {
      "uid": "{{body.id}}",
      "metadata": {
        "type": "text",
        "value": "{{body.user}}"
      }
    },
    "log": {
      "sanitize": [
        "request.headers.authorization"
      ]
    }
  },
  "invalidate": {
    "url": "https://www.example.com/oauth/invalidate",
    "headers": {
      "authorization": "Bearer {{connection.accessToken}}"
    },
    "log": {
      "sanitize": [
        "request.headers.authorization"
      ]
    }
  }
}

Set Connection Section

put

Available sections: api, parameters, scopes, scope, installSpec, install

Authorizations
Path parameters
SDK_connectionNamestringRequired
SDK_connectionSectionstringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Content-TypestringOptionalExample: application/jsonc
Body
typestringOptional
nazdarstringOptional
Responses
200
Successful response
application/json
put
PUT /api/v2/sdk/apps/connections/{SDK_connectionName}/{SDK_connectionSection} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

[
  {
    "type": "text",
    "nazdar": "molly"
  }
]
200

Successful response

{
  "change": {}
}

Get Connection Common

get
Authorizations
Path parameters
SDK_connectionNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Responses
200
Successful response
application/json
get
GET /api/v2/sdk/apps/connections/{SDK_connectionName}/common HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "clientId": "ENTER_CLIENT_ID_HERE",
  "clientSecret": "ENTER_CLIENT_SECRET_HERE"
}

Set Connection Common

put
Authorizations
Path parameters
SDK_connectionNamestringRequired
Query parameters
allbooleanOptionalExample: true
opensourcebooleanOptionalExample: true
Header parameters
imt-adminintegerOptionalExample: 1
Content-TypestringOptionalExample: application/json
Body
clientIdstringOptional
clientSecretstringOptional
Responses
200
Successful response
application/json
put
PUT /api/v2/sdk/apps/connections/{SDK_connectionName}/common HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "clientId": "ENTER_CLIENT_ID_HEREEEEE",
  "clientSecret": "ENTER_CLIENT_SECRET_HERE"
}
200

Successful response

{
  "changed": true
}

Recreate Connection

post

Recreates an existing app connection and synchronises it with HQ.

Authorizations
Path parameters
SDK_connectionNamestringRequired
Responses
200
Successful response
application/json
post
POST /api/v2/sdk/apps/connections/{SDK_connectionName}/recreate HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appConnection": "custom-app-13"
}