Connections

Create connection

Create a connection from credentials you already hold, for any connection type whose auth_methods include "manual". The credentials are verified with the provider before anything is stored, so a successful response means the connection works. OAuth-only types cannot be created this way; use POST /v1/connections/auth-link instead.

post/v1/connections

Request

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

Request body

connection_typestring required

A connection type whose auth_methods include "manual". See GET /v1/connections/types.

namestring required

Your label for the connection. For white-label types, posting the same type and name again replaces the stored credentials in place. Slack and Shopify are keyed on the workspace and store instead, and API-key types (Ahrefs, SEMrush, Adjust, DataForSEO, OpenAI Ads) always create a new connection.

credentialsobject required

Exactly the credential_fields the type lists. A missing or unrecognised field is rejected before any call to the provider.

is_privateboolean

Whether the connection should be private to the API-key user. Defaults to false, meaning shared with the workspace so other team members can see and use it. Omit it when replacing credentials on an existing connection and the current visibility is kept.

Example request

{
  "connection_type": "gads",
  "name": "Acme Agency Google Ads",
  "credentials": {
    "client_id": "1234567890-abc123.apps.googleusercontent.com",
    "client_secret": "GOCSPX-...",
    "refresh_token": "1//0g..."
  }
}

Response

Connection created and verified.

idstring nullable required

Public Markifact connection ID.

typestring required

Connection type.

display_namestring nullable

external_idstring nullable

is_privateboolean required

created_atinteger nullable

updated_atinteger nullable

Changes

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