List connection types
curl --request GET \
--url https://api.markifact.com/v1/connections/types \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.markifact.com/v1/connections/types"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.markifact.com/v1/connections/types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.markifact.com/v1/connections/types",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.markifact.com/v1/connections/types"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.markifact.com/v1/connections/types")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.markifact.com/v1/connections/types")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"type": "<string>",
"name": "<string>",
"auth_methods": [
"oauth"
],
"credential_fields": [
"<string>"
],
"docs_url": "https://docs.markifact.com/nodes/meta_ads/meta_ads_custom_app.md"
}
]Connections
List connection types
List every connection type Markifact supports and how each one can be authenticated.
GET
/
v1
/
connections
/
types
List connection types
curl --request GET \
--url https://api.markifact.com/v1/connections/types \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.markifact.com/v1/connections/types"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.markifact.com/v1/connections/types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.markifact.com/v1/connections/types",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.markifact.com/v1/connections/types"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.markifact.com/v1/connections/types")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.markifact.com/v1/connections/types")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"type": "<string>",
"name": "<string>",
"auth_methods": [
"oauth"
],
"credential_fields": [
"<string>"
],
"docs_url": "https://docs.markifact.com/nodes/meta_ads/meta_ads_custom_app.md"
}
]Returns every connection type Markifact supports, with how each one can be authenticated and, for types that accept credentials, the fields they expect.
Read
Where each credential actually comes from is explained on the page at
auth_methods to decide which endpoint to call:
auth_methods contains | How to connect |
|---|---|
oauth | Create an auth link and send your user through it. |
manual | Create the connection directly by posting the credential_fields. |
docs_url. It is served as plain markdown, so an agent can fetch and read it as is.
A type listing both can be connected either way. Using your own platform app on those channels is a white-label connection, so your clients never see Markifact in their account.
Endpoint
GET /v1/connections/types
Example Request
curl https://api.markifact.com/v1/connections/types \
-H "Authorization: Bearer YOUR_API_KEY"
Response
[
{
"type": "gads",
"name": "Google Ads",
"auth_methods": ["oauth", "manual"],
"credential_fields": ["client_id", "client_secret", "refresh_token"],
"docs_url": "https://docs.markifact.com/nodes/gads/gads_custom_app.md"
},
{
"type": "meta_ads",
"name": "Meta Ads",
"auth_methods": ["oauth", "manual"],
"credential_fields": ["access_token"],
"docs_url": "https://docs.markifact.com/nodes/meta_ads/meta_ads_custom_app.md"
},
{
"type": "shopify",
"name": "Shopify",
"auth_methods": ["manual"],
"credential_fields": ["store_id", "client_id", "client_secret"],
"docs_url": null
},
{
"type": "hubspot",
"name": "HubSpot",
"auth_methods": ["oauth"],
"credential_fields": null,
"docs_url": null
}
]
Fields
| Field | Type | Description |
|---|---|---|
type | string | The value to use as connection_type when creating a connection or an auth link. |
name | string | Human-readable connection type name. |
auth_methods | array | Any of oauth and manual. An empty array means the type is connected through its own flow and neither endpoint applies. |
credential_fields | array, null | The exact keys to send under credentials, in the order the Markifact app asks for them. Null for types that take no credentials. |
docs_url | string, null | A plain-markdown page explaining where each credential comes from. Fetch it directly; it needs no scraping. Null for types that have no page yet. |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
200 - application/json
Connection types returned.
How this type can be authenticated. An "oauth" type accepts a shared auth link; a "manual" type is created by posting credentials to POST /v1/connections. A type listing both can be connected either way, and using your own app there is a white-label connection.
Available options:
oauth, manual Credential field names a manual connection of this type expects. Null for types that take no credentials: OAuth-only types, and the ones connected only in the Markifact app.
Plain-markdown page explaining where each credential comes from, suitable for an agent to read directly. Null for types that have no page yet.
Example:
"https://docs.markifact.com/nodes/meta_ads/meta_ads_custom_app.md"