v1

latestOpenAPI 3.1.02026-08-04282319386.0 KB

integrations

Controller Handle Create Connection

Create a new connection, with properly encrypted creds

post/integrations/connections/create

Request body

_ownerstring required

ID of user that created this entry.

_orgstring required

ID of user's active organization when creating this entry.

validatedboolean

Whether we've tested and validated these credentials actually work. Relevant due to us persisting credentials before we attempt imports (rather than how we used to do it, after) to help with bug triage, particularly when errors occur during the initial /commit/import call and not during the followup task doing the actual import.

configobject required

JSON object specifying config on the connection. This is a value whose format WE specify; it needs to have enough information that we can map it to either a Meltano extractor or loader, but is fully distinct from either of those concepts. Avoiding coupling both this and table specifiers to whether they are pulling data in or sending data out is very useful and gives us very powerful generalization capabilities.

Response

Successful Response

string required