Skip to main content
POST
Create REST discovery connection

Authorizations

Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Body

application/json
configName
string
required

Unique connection config name (tenant-scoped)

Required string length: 1 - 255
Example:

"pagbank-prod"

connectorType
enum<string>
required

REST connector type this connection serves

Available options:
PAGBANK,
STRIPE,
PIX_BCB
Minimum string length: 1
Example:

"PAGBANK"

apiKey
string

Stripe restricted API key

Maximum string length: 512
baseURL
string<uri>

Optional per-connection API base URL (http/https); when omitted the deployment default for the connector type is used

Maximum string length: 2048
Example:

"https://sandbox.provider.example"

clientCert
string

PEM-encoded Pix client certificate

Maximum string length: 8192
clientID
string

Pix OAuth2 client id

Maximum string length: 512
clientKey
string

PEM-encoded Pix client private key

Maximum string length: 8192
clientSecret
string

Pix OAuth2 client secret

Maximum string length: 512
ediToken
string

PagBank EDI token

Maximum string length: 512
establishmentID
string

PagBank establishment id

Maximum string length: 512

Response

Created

configName
string
required

Connection configuration name

Example:

"prod-ledger-db"

databaseName
string
required

Database name

Example:

"ledger"

databaseType
string
required

Database engine type (canonical engine token as stored)

Example:

"POSTGRESQL"

host
string
required

Database host; empty for REST connector connections, whose service address is reported as baseURL

Example:

"db.internal.example.com"

id
string
required

Internal Matcher connection identifier

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

lastSeenAt
string<date-time>
required

Timestamp the connection was last observed healthy (RFC 3339)

Example:

"2026-06-17T14:32:05Z"

port
integer<int64>
required

Database port

Example:

5432

schemaDiscovered
boolean
required

Whether table schemas have been discovered for this connection

status
string
required

Current lifecycle status of the connection as reported by the extraction engine

Example:

"available"

userName
string
required

Database user name the connection authenticates as

Example:

"matcher_ro"

baseURL
string<uri>

Per-connection API base URL of a REST connector connection; absent when the deployment default applies and for database connectors

Example:

"https://sandbox.provider.example"

schema
string

Schema/namespace within the database, when set

Example:

"public"