Connections

List connection types

List every connection type Markifact supports, with how each one can be authenticated and, for manual types, the credential fields it expects.

get/v1/connections/types

Request

  • Base URL: https://api.markifact.com
  • URL: https://api.markifact.com/v1/connections/types
  • Auth: HTTP bearer

Response

Connection types returned.

typestring required
namestring required
auth_methodsstring[] required

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.

credential_fieldsstring[] nullable

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.

docs_urlstring uri nullable

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 response

[
  {
    "docs_url": "https://docs.markifact.com/nodes/meta_ads/meta_ads_custom_app.md"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.