Skip to main content
GET
Get a single connector by type

Authorizations

Authorization
string
header
required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Path Parameters

connector_type
enum<string>
required

Connector type. Enum: stripe, avatax, shippo, printnode, postmark, shopify, mapquest, google, openai, plaid, ups, fedex, usps, amazon, ebay, wwex

Available options:
stripe,
avatax,
shippo,
printnode,
postmark,
shopify,
mapquest,
google,
openai,
plaid,
ups,
fedex,
usps,
amazon,
ebay,
wwex

Query Parameters

mode
enum<string>

If omitted, returns the row matching the entity's current environment.

Available options:
sandbox,
live

Response

Connector row (credentials NEVER included; has_credentials_secret_arn indicates if credentials are stored)

data
object

A configured connector row from entity_connectors. SECURITY: credentials, webhook_secret, and credentials_secret_arn RAW VALUES are NEVER returned. has_credentials_secret_arn (boolean) indicates if credentials are stored. credentials_masked returns key names only (no values). These invariants are enforced by the canonical listConnectors/getConnectorByType handler projection and cannot be overridden by callers.