Skip to main content
GET
/
v1
/
connections
List connections
curl --request GET \
  --url https://api.markifact.com/v1/connections \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "type": "<string>",
    "is_private": true,
    "display_name": "<string>",
    "external_id": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.markifact.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns shared connections owned by your team, plus private connections owned by the user who created the API key.

​
Endpoint

GET /v1/connections

​
Query Parameters

ParameterTypeRequiredDescription
external_idstringNoFilter connections by the external ID you provided when creating the auth link.
typestringNoFilter connections by connection type, such as ga4, gads, or meta_ads.

​
Example Request

curl "https://api.markifact.com/v1/connections?external_id=customer_123&type=ga4" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

[
  {
    "id": "1f2e3d4c-0000-0000-0000-000000000000",
    "type": "ga4",
    "display_name": "login@example.com",
    "external_id": "customer_123",
    "is_private": false,
    "created_at": 1764000000000,
    "updated_at": 1764000000000
  }
]

​
Connection Object

FieldTypeDescription
idstringPublic Markifact connection ID.
typestringConnection type.
display_namestring or nullDisplay name for the connection.
external_idstring or nullExternal ID from the auth link, if provided.
is_privatebooleanWhether the connection is private to the API key’s owning user.
created_atinteger or nullCreated timestamp in milliseconds.
updated_atinteger or nullUpdated timestamp in milliseconds.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
external_id
string

Filter connections by the external ID you provided when creating the auth link.

​
type
string

Filter connections by connection type.

Example:

"ga4"

Response

Connections returned.

​
id
string | null
required

Public Markifact connection ID.

​
type
string
required

Connection type.

​
is_private
boolean
required
​
display_name
string | null
​
external_id
string | null
​
created_at
integer<int64> | null
​
updated_at
integer<int64> | null