SDK Apps > Connections

PreviousSDK Apps > Functions NextSDK Apps > Webhooks

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

application/json

objectOptional

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

application/json

objectOptional

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"
}

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

application/json

objectOptional

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"
      ]
    }
  }
}

Get Connection Common

get

Authorizations

Path parameters

SDK_connectionNamestringRequired

Query parameters

allbooleanOptionalExample: true

opensourcebooleanOptionalExample: true

Header parameters

imt-adminintegerOptionalExample: 1

Responses

application/json

objectOptional

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"
}

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

application/json

objectOptional

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

application/json

objectOptional

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"
  }
}

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

application/json

objectOptional

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"
  }
}

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

application/json

objectOptional

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": {}
}

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

application/json

objectOptional

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
}